Minden előfizetéshez RESTful API hozzáférést biztosítunk.
Kösd össze webshopod, gyártási rendszered, CRM-ed vagy szigetrendszered
a Logzi ERP-vel – JSON válaszokkal, API-kulcsos hitelesítéssel.
# Partner lista lekérdezése API kulccsal curl -X GET \ "https://app.logzi.com/api/partner/list?list_count=5" \ -H "X-API-KEY: your-secret-api-key" # ✓ 200 OK — JSON válasz: { "result": { "code": 1, "message": null }, "data": [ { "id": 42, "company_name": "Példa Kft.", "tax_number": "12345678-1-01" } ] }
Minden API kéréshez szükséges az egyedi API-kulcsod, amelyet a Logzi fiókod Beállítások → Integráció menüpontjában találsz.
Fiókodban a Beállítások → Integráció oldalon hozd létre az API kulcsodat. Minden előfizetési szinthez jár.
Az összes HTTP kérés X-API-KEY fejlécébe illeszd be a kulcsodat. GET és POST kéréseknél egyaránt.
Ellenőrizd a result.code értékét: 1 = siker, 0 = hiba. A data mező tartalmazza az ERP adatokat.
# cURL – X-API-KEY fejléc minden kéréshez curl -X GET \ "https://app.logzi.com/api/partner/get?id=42" \ -H "X-API-KEY: abc123def456ghi789" \ -H "Content-Type: application/json" # PHP – cURL fejléc beállítása $ch = curl_init(); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'X-API-KEY: abc123def456ghi789', 'Content-Type: application/json', ]); # Érvénytelen kulcs esetén a válasz: { "result": { "code": 0, "message": "Unauthorized" }, "data": null }
Válaszd ki a programozási nyelvedet és másold be a kódot – a partnerek listáját kérdezi le a Logzi API-ból.
<?php require_once 'vendor/autoload.php'; use Logzi\Api\LogziClient; // 1. Kliens inicializálása az API kulcsoddal $client = new LogziClient([ 'api_key' => 'your-secret-api-key', 'base_url' => 'https://app.logzi.com/api/', ]); // 2. Partnerek listájának lekérdezése (paginált) $response = $client->partner()->list([ 'list_offset' => 0, 'list_count' => 25, ]); // 3. Eredmény feldolgozása if ($response['result']['code'] === 1) { foreach ($response['data'] as $partner) { echo $partner['id'] . ' – ' . $partner['company_name'] . "\n"; } } else { echo 'Hiba: ' . $response['result']['message']; }
# Partnerek listája – alap GET kérés 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" # Szűrés list_condition paraméterrel (csak vevők) 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" # Keresés cégnév alapján 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'; // Általános GET segédfüggvény 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(); } // Partnerek listázása 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", } # Partnerek listájának lekérése 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("Hiba:", data["result"]["message"])
Minden API végpont azonos JSON struktúrával válaszol.
A result.code értéke jelzi a hívás sikerességét: 1 = siker, 0 = hiba.
{
"result": {
"code": 1, ← Sikeres
"message": null ← Nincs hibaüzenet
},
"data": {
"id": 42,
"company_name": "Példa Kft.",
// ... további mezők
}
}
{
"result": {
"code": 0, ← Hiba
"message": "Not found" ← Hibaüzenet
},
"data": null ← Nincs adat
}
// Lehetséges üzenetek:
// "Unauthorized" – érvénytelen API kulcs
// "Not found" – nem létező erőforrás
Az optimális teljesítmény és biztonság érdekében vedd figyelembe az alábbi korlátokat és javaslatokat.
Végpontonként legfeljebb 100 kérés / 30 másodperc engedélyezett. Ezt meghaladva HTTP 429 választ kapsz.
X-RateLimit-Limit: 100 X-RateLimit-Remaining: 95 X-RateLimit-Reset: 1712345678
Listás végpontoknál mindig használd a list_offset és list_count paramétereket a memória és sebesség optimalizáláshoz.
# 1. lap (0–24. elem) ?list_offset=0&list_count=25 # 2. lap (25–49. elem) ?list_offset=25&list_count=25
Az API kulcsodat mindig biztonságosan tárold – soha ne tedd nyilvánossá forráskódban, frontend JS-ben vagy publikus repository-ban.
.env fájlban.gitignore nélkül!A Logzi szoftverrel kapcsolatos tudnivalókat igyekszünk egy helyre csoportosítani – az alábbiakban kategóriába szerveztük.
Szoftverünkkel kapcsolatban feltett, gyakran ismételt kérdések és válaszok egy helyen.
A szoftverről készített dokumentáció, amely tartalmazza a modulokat, funkciókat és SDK hívásokat.
Nyiss egy ticket-et, melyre kollégáink vagy a közösség rövid időn belül reagál és segít.
Kösd össze webshopod, gyártási rendszered vagy bármilyen szigetrendszered a Logzi API interfészével. Az SDK-val a legtöbb integrációt percek alatt megvalósíthatod.
