Ku každému predplatnému poskytujeme prístup cez RESTful API.
Prepoj svoj e-shop, výrobný systém, CRM alebo akýkoľvek izolovaný systém
s Logzi ERP – s JSON odpoveďami a autentifikáciou pomocou API kľúča.
# Získanie zoznamu partnerov pomocou API kľúča curl -X GET \ "https://app.logzi.com/api/partner/list?list_count=5" \ -H "X-API-KEY: your-secret-api-key" # ✓ 200 OK — JSON odpoveď: { "result": { "code": 1, "message": null }, "data": [ { "id": 42, "company_name": "Príklad s.r.o.", "tax_number": "12345678-1-01" } ] }
Pre každú API požiadavku je potrebný tvoj jedinečný API kľúč, ktorý nájdeš vo svojom Logzi konte v sekcii Nastavenia → Integrácia.
Vytvor si API kľúč na stránke Nastavenia → Integrácia vo svojom konte. Súčasť každej úrovne predplatného.
Vlož svoj kľúč do hlavičky X-API-KEY pri každej HTTP požiadavke — pri GET aj POST volaniach.
Skontroluj hodnotu result.code: 1 = úspech, 0 = chyba. Pole data obsahuje ERP dáta.
# cURL – hlavička X-API-KEY pri každej požiadavke curl -X GET \ "https://app.logzi.com/api/partner/get?id=42" \ -H "X-API-KEY: abc123def456ghi789" \ -H "Content-Type: application/json" # PHP – nastavenie hlavičky cURL $ch = curl_init(); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'X-API-KEY: abc123def456ghi789', 'Content-Type: application/json', ]); # Odpoveď pri neplatnom kľúči: { "result": { "code": 0, "message": "Unauthorized" }, "data": null }
Vyber si programovací jazyk a vlož kód – načíta zoznam partnerov z Logzi API.
<?php require_once 'vendor/autoload.php'; use Logzi\Api\LogziClient; // 1. Inicializácia klienta s tvojím API kľúčom $client = new LogziClient([ 'api_key' => 'your-secret-api-key', 'base_url' => 'https://app.logzi.com/api/', ]); // 2. Získanie zoznamu partnerov (stránkovane) $response = $client->partner()->list([ 'list_offset' => 0, 'list_count' => 25, ]); // 3. Spracovanie výsledku if ($response['result']['code'] === 1) { foreach ($response['data'] as $partner) { echo $partner['id'] . ' – ' . $partner['company_name'] . "\n"; } } else { echo 'Chyba: ' . $response['result']['message']; }
# Zoznam partnerov – základná GET požiadavka curl -X GET \ "https://app.logzi.com/api/partner/list?list_offset=0&list_count=25" \ -H "X-API-KEY: your-secret-api-key" \ -H "Content-Type: application/json" # Filtrovanie pomocou parametra list_condition (len zákazníci) curl -G \ "https://app.logzi.com/api/partner/list" \ --data-urlencode "list_condition[is_customer]=1" \ --data-urlencode "list_count=50" \ -H "X-API-KEY: your-secret-api-key" # Vyhľadávanie podľa názvu firmy curl -X GET \ "https://app.logzi.com/api/partner/get?company_name=P%C3%A9lda+Kft." \ -H "X-API-KEY: your-secret-api-key"
const API_KEY = 'your-secret-api-key'; const BASE_URL = 'https://app.logzi.com/api'; // Všeobecná pomocná GET funkcia async function logziGet(endpoint, params = {}) { const qs = new URLSearchParams(params).toString(); const res = await fetch(`${BASE_URL}/${endpoint}?${qs}`, { method: 'GET', headers: { 'X-API-KEY': API_KEY, 'Content-Type': 'application/json', }, }); return res.json(); } // Výpis partnerov const result = await logziGet('partner/list', { list_offset: 0, list_count: 25, }); if (result.result.code === 1) { result.data.forEach(p => console.log(p.company_name)); }
import requests API_KEY = "your-secret-api-key" BASE_URL = "https://app.logzi.com/api" headers = { "X-API-KEY": API_KEY, "Content-Type": "application/json", } # Získanie zoznamu partnerov response = requests.get( f"{BASE_URL}/partner/list", headers=headers, params={"list_offset": 0, "list_count": 25}, ) data = response.json() if data["result"]["code"] == 1: for partner in data["data"]: print(partner["company_name"]) else: print("Chyba:", data["result"]["message"])
Každý API endpoint odpovedá rovnakou JSON štruktúrou.
Hodnota result.code udáva úspešnosť volania: 1 = úspech, 0 = chyba.
{
"result": {
"code": 1, ← Úspech
"message": null ← Žiadna chybová správa
},
"data": {
"id": 42,
"company_name": "Príklad s.r.o.",
// ... ďalšie polia
}
}
{
"result": {
"code": 0, ← Chyba
"message": "Not found" ← Chybová správa
},
"data": null ← Žiadne dáta
}
// Možné správy:
// "Unauthorized" – neplatný API kľúč
// "Not found" – neexistujúci zdroj
Pre optimálny výkon a bezpečnosť zohľadni nasledujúce limity a odporúčania.
Na jeden endpoint je povolených maximálne 100 požiadaviek / 30 sekúnd. Pri prekročení dostaneš odpoveď HTTP 429.
X-RateLimit-Limit: 100 X-RateLimit-Remaining: 95 X-RateLimit-Reset: 1712345678
Pri zoznamových endpointoch vždy použi parametre list_offset a list_count na optimalizáciu pamäte a rýchlosti.
# 1. strana (položky 0–24) ?list_offset=0&list_count=25 # 2. strana (položky 25–49) ?list_offset=25&list_count=25
API kľúč vždy bezpečne uchovávaj – nikdy ho nezverejňuj v zdrojovom kóde, frontend JS ani vo verejnom repozitári.
.env.gitignore!Snažíme sa zhromaždiť všetky informácie o softvéri Logzi na jednom mieste – nižšie sme ich usporiadali do kategórií.
Často kladené otázky a odpovede o našom softvéri na jednom mieste.
Dokumentácia k softvéru, ktorá obsahuje moduly, funkcie a SDK volania.
Otvor ticket, na ktorý čoskoro zareagujú naši kolegovia alebo komunita a pomôžu ti.
Prepoj svoj e-shop, výrobný systém alebo akýkoľvek izolovaný systém s rozhraním Logzi API. Pomocou SDK dokážeš väčšinu integrácií zrealizovať za pár minút.
