Základná URL
https://{tenant}.logzi.com/api/integration_webhook/
Každá požiadavka vracia odpoveď vo formáte JSON. Pri úspešnej odpovedi je result.code == 1, pri chybe result.code == 0. Záznamy webhookov uchovávajú upozornenia na udalosti, ktoré sa majú odoslať smerom k integrácii (napr. nová objednávka, vystavenie faktúry). Pole sended označuje, či už bol webhook odoslaný.
/api/integration_webhook/get
Získanie jedného záznamu webhooku podľa identifikátora.
Query parametre
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor záznamu webhooku |
Príklad požiadavky
GET /api/integration_webhook/get?id=200
X-API-KEY: {vas_api_kluc}
/api/integration_webhook/list
Získanie stránkovateľného zoznamu záznamov webhookov.
Query parametre
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
list_offset | int | Posun stránkovania (predvolené: 0) | |
list_condition | object | Objekt s filtrovacími podmienkami |
Príklad požiadavky
GET /api/integration_webhook/list?list_offset=0
X-API-KEY: {vas_api_kluc}
/api/integration_webhook/save
Vytvorenie alebo úprava záznamu webhooku. Pri úprave je možné aktualizovať iba pole sended. Pre nový záznam data[id] = 0.
POST polia — objekt data
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | int | 0 = nový záznam, >0 = úprava (aktualizácia sended) | |
integration_id | int | Identifikátor integrácie | |
integration_webhook_type_id | int | Typ udalosti webhooku | |
receipt_id | int | Identifikátor súvisiaceho dokladu | |
receipt_type_id | int | Typ dokladu | |
product_id | int | Identifikátor súvisiaceho produktu | |
request | string | Obsah odoslanej požiadavky (JSON) | |
request_url | string | URL požiadavky | |
response | string | Obsah prijatej odpovede | |
sended | int | 1 = odoslané (pri úprave) |
Príklad požiadavky
POST /api/integration_webhook/save
X-API-KEY: {vas_api_kluc}
Content-Type: application/json
{
"data": {
"id": 0,
"integration_id": 1,
"integration_webhook_type_id": 3,
"receipt_id": 150,
"receipt_type_id": 2
}
}
/api/integration_webhook/delete
Odstránenie záznamu webhooku podľa identifikátora.
POST polia — objekt data
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor webhooku, ktorý sa má odstrániť |
Príklad požiadavky
POST /api/integration_webhook/delete
X-API-KEY: {vas_api_kluc}
Content-Type: application/json
{ "data": { "id": 200 } }
/api/integration_webhook/close
Uzavretie záznamu webhooku — označenie ako odoslané a zaznamenanie údajov odpovede.
POST polia — objekt data
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor webhooku, ktorý sa má uzavrieť | |
response | string | Obsah prijatej odpovede | |
response_http_code | string | HTTP stavový kód |
Príklad požiadavky
POST /api/integration_webhook/close
X-API-KEY: {vas_api_kluc}
Content-Type: application/json
{ "data": { "id": 200, "response_http_code": "200" } }
Zaregistruj sa teraz,
zaplať neskôr!