Creează o cheie API
Generați chei API cu permisiuni limitate, restricție pe IP și expirare, ca TMS-ul, ERP-ul sau site-ul să lucreze cu GoCargo.
- Plan Pro, Business sau Enterprise (sau licență API comercială)
- Rol de administrator al firmei
Pe această pagină (6 pași)
- 1
Deschideți cheile API
Din meniul contului, Cont și setări → Chei API și webhooks. Apăsați „Cheie nouă”.
Cheie nouă
- 2
Numiți cheia și alegeți mediul
La „Numele cheii” scrieți un nume (ex. „TMS producție”). La „Mediu” alegeți „Live” sau „Test”.
Cu o cheie de test, anunțurile nu apar în bursă și se șterg singure după 24 de ore. Nu se pot crea comenzi.
- 3
Alegeți permisiunile
La „Permisiuni” alegeți „Doar publicare curse”, „Integrare TMS” sau „Acces complet” (tot ce permite planul). Din „Avansat” → „Permisiuni individuale” bifați exact ce trebuie.
Dați cheii doar ce îi trebuie. O cerere fără permisiunea necesară primește 403 scope_missing.
- 4
Restricționați IP-ul și expirarea
Tot în „Avansat”, adăugați IP-uri sau intervale CIDR (gol = orice IP) și alegeți „Expirare”: „Niciodată”, „30 de zile”, „90 de zile” sau „Un an”. Opțional, bifați „Semnătură HMAC obligatorie”.
- 5
Creați și copiați cheia
Apăsați „Creează cheia”. Copiați cheia (și secretul de semnare, dacă ați cerut HMAC), apoi „Am salvat cheia”.
Creează cheiaCheia nu se mai afișează niciodată. Dacă o pierdeți, o revocați și creați alta. Nu o puneți în HTML sau JavaScript din browser.
- 6
Urmăriți și revocați
Lista arată permisiunile, ultima folosire și IP-ul. „Jurnal” arată ultimele cereri făcute cu cheia. „Revocă” o oprește imediat.
Revocă
Întrebări frecvente
Ce planuri includ API-ul?
Pro, Business și Enterprise, sau orice plan cu o licență API comercială (Integrator software, Partener bursă / agregator).
Câte cereri pot face?
Pe cheie: 60 pe minut pe Pro, 300 pe Business, 1.200 pe Enterprise. Pe lună, pe firmă: 50.000, 300.000, respectiv 2.000.000. Peste cotă, API-ul răspunde 429 quota_exceeded; puteți adăuga pachete de 100.000 de cereri (39 lei/lună).
Câte chei pot avea?
Cel mult 20 de chei active pe firmă.
Dispecerii pot crea chei?
Nu. Doar administratorii firmei pot gestiona cheile API și webhook-urile.
Ghiduri legate
- Primește evenimentele prin webhooksGoCargo trimite un POST JSON semnat către sistemul dvs. când apare o comandă nouă, se schimbă un status sau primiți un mesaj.
- Documentația API pentru dezvoltatoriGhidul tehnic de la /dezvoltatori: pornire rapidă, autentificare, limite, idempotency, mod test, webhooks și semnătura HMAC.
- Compară planurile și alege abonamentul potrivitVezi ce include fiecare plan (Gratuit, Start, Pro, Business, Enterprise), cât costă și pe care să îl alegi.
Consultantul GoCargoAI răspunde imediat; echipa de suport, în mesaje.