Primește evenimentele prin webhooks
GoCargo trimite un POST JSON semnat către sistemul dvs. când apare o comandă nouă, se schimbă un status sau primiți un mesaj.
- Toate firmele
- 5 pași
- Înainte de a începe
Plan cu API (Pro, Business, Enterprise)
Rol de administrator al firmei
Pe această pagină (5 pași)
- 1
Deschideți Webhooks
În Cont și setări → Chei API și webhooks, deschideți secțiunea Webhooks.
- 2
Adăugați endpoint-ul
La Endpoint nou scrieți URL (o adresă https://), opțional o Descriere, și bifați Evenimente: încărcături (publicată, modificată, rezervată, retrasă, ofertă de preț primită), comenzi (comandă nouă, status schimbat, document adăugat, poziție actualizată) și mesaje primite. Apăsați Adaugă endpoint.
- 3
Salvați secretul
Copiați secretul whsec_… și apăsați Am salvat secretul. Cu el verificați antetul GoCargo-Signature.
Atenție·Secretul se afișează o singură dată.
- 4
Testați legătura
Apăsați Trimite test și verificați Ultimele livrări: livrat, în așteptare, se reîncearcă, eșuat sau abandonat.
- 5
Răspundeți corect
Sistemul dvs. trebuie să răspundă cu un cod 2xx în cel mult 10 secunde. Altfel reîncercăm după 1 min, 5 min, 30 min, 2 h, 6 h și 24 h.
Atenție·După 50 de eșecuri la rând, endpoint-ul se dezactivează și administratorii sunt anunțați.
Întrebări frecvente
Pe ce adrese pot primi webhooks?
Doar pe domeniile firmei și subdomeniile lor, prin HTTPS. Primul webhook își adaugă singur domeniul; restul le vedeți la Domeniile firmei.
Pot primi același eveniment de două ori?
Da, se poate. Folosiți câmpul id ca să ignorați dublurile.
Câte endpoint-uri pot avea?
Cel mult 10 webhook-uri pe firmă.
Ghiduri legate
- Creează o cheie APIGenerați chei API cu permisiuni limitate, restricție pe IP și expirare, ca TMS-ul, ERP-ul sau site-ul să lucreze cu GoCargo.
- Documentația API pentru dezvoltatoriGhidul tehnic de la /dezvoltatori: pornire rapidă, autentificare, limite, idempotency, mod test, webhooks și semnătura HMAC.
Consultantul GoCargoAI răspunde imediat; echipa de suport, în mesaje.