DocsAutentificare
Aflați cum să vă autentificați cu API-ul Cost+
Toată comunicarea cu API-ul Cost+ necesită TLS 1.2 sau superior și autentificare HTTP Basic.
Cum funcționează autentificarea Basic
Autentificați-vă folosind cheia API ca nume de utilizator cu o parolă goală. Codificați în Base64 șirul \{api_key\}: (observați două puncte la final — parola este goală).
Headerul Authorization rezultat arată astfel:
Authorization: Basic aHVudGVyMjo=Nu expuneți niciodată cheia API în codul client-side sau în depozite publice. Păstrați-o doar pe partea de server.
Utilizarea cURL
Metoda implicită (recomandat)
cURL suportă nativ autentificarea Basic cu flag-ul -u. Transmiteți cheia API urmată de două puncte:
curl -u YOUR_API_KEY: https://api.costplus.online/v1/orders/Codificare manuală Base64
Dacă preferați să construiți headerul manual, codificați mai întâi cheia:
echo -n "YOUR_API_KEY:" | base64Apoi transmiteți valoarea codificată în headerul Authorization:
curl -H "Authorization: Basic YOUR_BASE64_ENCODED_KEY" https://api.costplus.online/v1/orders/Două puncte de la finalul cheii API sunt obligatorii — acestea separă numele de utilizator de parola (goală) în schema de autentificare Basic.
Coduri de stare HTTP
API-ul folosește coduri de stare HTTP standard pentru a indica rezultatul unei cereri.
| Cod de stare | Semnificație | Descriere |
|---|---|---|
| 200 | OK | Cererea a reușit. |
| 201 | Creat | Resursa a fost creată cu succes. |
| 400 | Cerere incorectă | Cererea a fost malformată sau lipsesc câmpuri obligatorii. |
| 401 | Neautorizat | Autentificarea a eșuat — verificați cheia API. |
| 403 | Interzis | Nu aveți permisiunea de a accesa această resursă. |
| 404 | Negăsit | Resursa solicitată nu există. |
| 500 | Eroare internă de server | Ceva a mers greșit pe partea noastră. |
| 502 | Gateway incorect | Eroare de serviciu upstream. |
| 503 | Serviciu indisponibil | API-ul este temporar indisponibil. |
| 504 | Timeout gateway | Serviciul upstream nu a răspuns la timp. |