Autentificarea cu chei

Cere o cheie

O cheie se face din contul tău Ajungem.ro, în Profil → Dezvoltatori. Cere autentificare cu cont: nu există înregistrare separată pentru dezvoltatori.

Cheia are un singur titular: contul tău, sau firma ta, dacă ești proprietar. O firmă poate avea mai multe chei; un dispecer care nu e proprietar își face o cheie pe numele lui, nu a firmei.

Secretul se arată o singură dată, la creare. Dacă îl pierzi, retragi cheia și faci alta — nu-l putem arăta din nou, fiindcă păstrăm doar amprenta lui.

Trimite-o

curl https://api.ajungem.ro/v1/listings/mine \
  -H "Authorization: Bearer ajk_live_…"

const response = await fetch('https://api.ajungem.ro/v1/listings/mine', {
  headers: { Authorization: `Bearer ${process.env.AJUNGEM_API_KEY}` },
})
const { data } = await response.json()

Nu e nevoie de alt antet: firma și drepturile tale se stabilesc din cheie, nu dintr-un câmp trimis de tine.

Cine are voie

Cheile sunt o funcție de plan: Internațional, pentru transportatori, sau o opțiune business separată, pentru beneficiari (dealeri, ERP-uri) care n-au de ce să cumpere un plan de transportator — dată deocamdată manual, până există produs comercial pentru ea. Fără planul potrivit, crearea unei chei se refuză cu 402 plan_required.

Ce oprește o cheie

• Retragerea ei, din cont — imediată.
• Expirarea, dacă i-ai pus o dată.
• Suspendarea contului sau a firmei, din administrare.
• Pierderea planului cu API (abonamentul a expirat).

O cheie oprită întoarce 401 invalid_credential la orice cerere, fără să spună care dintre motive se aplică — integratorul nu are cum să afle detalii despre contul altcuiva din codul de eroare.

Prefixe