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
- 1
Deschideți cheile API
Din meniul contului, Cont și setări → Chei API și webhooks. Apăsați „Cheie nouă”.
Clave nueva
- 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”.
Con una clave de prueba, los anuncios no aparecen en la bolsa y se borran solos tras 24 horas. No se pueden crear pedidos.
- 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”.
Crear la claveLa clave no se vuelve a mostrar nunca. Si la pierde, la revoca y crea otra. No la ponga en HTML ni en JavaScript del navegador.
- 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.
Revocar
Î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.