Se incarca continutul...
Tot ce trebuie sa stii pentru a integra API-ul e-furnizori in aplicatia ta.
Poti face cereri GET la endpoint-urile publice fara autentificare (limitat la 60 req/min per IP).
Inregistreaza-te pe platforma pentru a obtine acces la Developer Dashboard.
Acceseaza Developer Dashboard pentru a genera o cheie API cu rate limit marit.
Foloseste cheia API in header-ul cererilor si consulta documentatia Swagger pentru toate endpoint-urile.
API-ul suporta doua metode de autentificare:
curl -H "X-API-Key: efz_your_key_here" https://e-furnizori.ro/api/productscurl -H "Authorization: Bearer efz_your_key_here" https://e-furnizori.ro/api/productsImportant
Pastreaza cheia API in siguranta. Nu o include in cod frontend sau repositoare publice. Foloseste variabile de mediu.
Toate cererile sunt supuse limitarii pentru a asigura performanta platformei.
HTTP/1.1 200 OK X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 999 X-RateLimit-Reset: 1704067200000
Endpoint-urile care returneaza liste suporta paginare standard.
| Parametru | Tip | Default | Descriere |
|---|---|---|---|
| page | integer | 1 | Numarul paginii |
| limit | integer | 12 | Rezultate per pagina (max 100) |
{
"success": true,
"data": [...],
"meta": {
"page": 1,
"limit": 20,
"total": 150,
"totalPages": 8
}
}API-ul returneaza erori in format consistent JSON.
{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Produsul nu a fost gasit",
"details": {}
}
}| Cod | Nume | Descriere | Solutie |
|---|---|---|---|
| 400 | Bad Request | Parametrii cererii sunt invalizi | Verifica parametrii trimisi si formatul lor |
| 401 | Unauthorized | API key lipsa sau invalid | Adauga header-ul X-API-Key cu o cheie valida |
| 403 | Forbidden | Permisiuni insuficiente pentru aceasta actiune | Verifica permisiunile cheii API sau contacteaza suportul |
| 404 | Not Found | Resursa ceruta nu exista | Verifica ID-ul sau slug-ul resursei |
| 429 | Too Many Requests | Ai depasit limita de cereri | Asteapta pana la reset sau obtine o cheie API cu limite mai mari |
| 500 | Server Error | Eroare interna a serverului | Reincearca mai tarziu sau contacteaza suportul |
Foloseste caching pentru date statice
Categoriile si informatiile furnizorilor se schimba rar. Cache-uieste-le local pentru 5-10 minute.
Implementeaza retry cu exponential backoff
La erori 429 sau 5xx, reincearca cu delay crescator (1s, 2s, 4s, etc).
Monitorizeaza headerele rate limit
Verifica X-RateLimit-Remaining si planifica cererile inainte de a ajunge la limita.
Pastreaza cheia API in siguranta
Foloseste variabile de mediu, nu include cheia in cod versionat sau aplicatii frontend.
Cere doar datele de care ai nevoie
Foloseste filtrele si paginarea pentru a reduce volumul datelor transferate.
Echipa noastra de suport este aici sa te ajute cu integrarea.