API keys — acces programatic la datele firmei

Despre acest ghid

Înveți cum să generezi și să folosești API keys pentru acces programatic la datele din Qedara Start.

Când ai nevoie de API keys

• Automatizări proprii (scripturi, RPA)
• Integrare cu ERP sau alte sisteme interne
• Extragere date pentru raportare BI
• Aplicații custom construite de echipa ta IT

Pasul 1 — Generează un API key

Mergi la Setări → API → + Cheie nouă.

Configurează:

⚠️ Cheia este afișată o singură dată la generare. Salvează-o imediat într-un password manager sau secret store.

Pasul 2 — Autentificare în API

Adaugă header-ul în fiecare request:

Authorization: Bearer qst_live_xxxxxxxxxxxxxxxxxxxx

Exemplu — Listare facturi emise

curl https://api.qedara.com/v1/invoices \
  -H "Authorization: Bearer qst_live_xxx" \
  -H "X-Entity-Id: ENT_123456" \
  -G --data-urlencode "from=2026-01-01" \
     --data-urlencode "to=2026-01-31"

Răspuns JSON:

{
  "data": [
    { "id": "INV_001", "number": "2026/001", "total": 1190.00, "status": "paid" }
  ],
  "pagination": { "page": 1, "total": 47 }
}

Rate limiting

La depășire, API-ul returnează HTTP 429 cu header Retry-After.

Rotire și revocare

Bune practici:

• Rotește cheile la fiecare 90 de zile
• Revocă imediat cheile neutilizate sau compromise
• Folosește chei separate pentru medii diferite (dev/staging/prod)

Revocare: Setări → API → [cheie] → Revocă. Efectul este imediat.

Documentație completă API

Documentația Swagger/OpenAPI: Setări → API → Vezi documentație sau la https://api.qedara.com/docs.

Articole conexe