Webhook API

Verwaltung ausgehender Webhook-Nachrichten — Abrufen und Statusverwaltung von Integrations-Ereignisbenachrichtigungen

Basis-URL

https://{tenant}.logzi.com/api/integration_webhook/

Jede Anfrage liefert eine JSON-Antwort zurück. Bei Erfolg ist result.code == 1, im Fehlerfall result.code == 0. Die Webhook-Einträge speichern die an die Integration zu sendenden Ereignisbenachrichtigungen (z. B. neue Bestellung, Rechnungsausstellung). Das Feld sended zeigt an, ob der Webhook bereits gesendet wurde.

GET /api/integration_webhook/get

Abrufen eines einzelnen Webhook-Eintrags anhand der ID.

Query-Parameter

ParameterTypPflichtfeldBeschreibung
idintID des Webhook-Eintrags

Beispielanfrage

GET /api/integration_webhook/get?id=200
X-API-KEY: {ihr_api_schluessel}
GET /api/integration_webhook/list

Abrufen einer paginierbaren Liste von Webhook-Einträgen.

Query-Parameter

ParameterTypPflichtfeldBeschreibung
list_offsetintPaginierungs-Offset (Standard: 0)
list_conditionobjectObjekt mit Filterbedingungen

Beispielanfrage

GET /api/integration_webhook/list?list_offset=0
X-API-KEY: {ihr_api_schluessel}
POST /api/integration_webhook/save

Erstellen oder Ändern eines Webhook-Eintrags. Bei einer Änderung kann nur das Feld sended aktualisiert werden. Für einen neuen Eintrag data[id] = 0.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
idint0 = neuer Eintrag, >0 = Änderung (Aktualisierung von sended)
integration_idintID der Integration
integration_webhook_type_idintTyp des Webhook-Ereignisses
receipt_idintID des zugehörigen Belegs
receipt_type_idintBelegtyp
product_idintID des zugehörigen Produkts
requeststringInhalt der gesendeten Anfrage (JSON)
request_urlstringURL der Anfrage
responsestringInhalt der erhaltenen Antwort
sendedint1 = gesendet (bei Änderung)

Beispielanfrage

POST /api/integration_webhook/save
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json

{
  "data": {
    "id": 0,
    "integration_id": 1,
    "integration_webhook_type_id": 3,
    "receipt_id": 150,
    "receipt_type_id": 2
  }
}
POST /api/integration_webhook/delete

Löschen eines Webhook-Eintrags anhand der ID.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
idintID des zu löschenden Webhooks

Beispielanfrage

POST /api/integration_webhook/delete
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json

{ "data": { "id": 200 } }
POST /api/integration_webhook/close

Abschließen eines Webhook-Eintrags — Markierung als gesendet und Erfassung der Antwortdaten.

POST-Felder — data-Objekt

FeldTypPflichtfeldBeschreibung
idintID des abzuschließenden Webhooks
responsestringInhalt der erhaltenen Antwort
response_http_codestringHTTP-Statuscode

Beispielanfrage

POST /api/integration_webhook/close
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json

{ "data": { "id": 200, "response_http_code": "200" } }

Nimm Kontakt mit uns auf

Interessierst du dich für unsere Software? Schreib uns einfach!

Brauchst du Hilfe?

Wenn du keine Antwort findest und Unterstützung brauchst

Jetzt registrieren,
später bezahlen!

Teste es 3 Tage kostenlos, ohne Risiko und Verpflichtungen!