Autentifikacia
Naucte sa, ako sa autentifikovat s Cost+ API
Vsetka komunikacia s Cost+ API vyzaduje TLS 1.2 alebo vyssie a HTTP Basic autentifikaciu.
Ako funguje Basic Auth
Autentifikujte sa pouzitim vasho API kluca ako mena pouzivatela s prazdnym heslom. Base64 zakodujte retazec \{api_key\}: (vsimnite si konciacu dvojbodku -- heslo je prazdne).
Vysledna hlavicka Authorization vyzera takto:
Authorization: Basic aHVudGVyMjo=Nikdy nevystavujte svoj API kluc v kode na strane klienta ani vo verejnych repozitaroch. Uchovavajte ho len na strane servera.
Pouzitie cURL
Priamo (odporucane)
cURL nativne podporuje Basic Auth s flagom -u. Zadajte svoj API kluc nasledovany dvojbodkou:
curl -u YOUR_API_KEY: https://api.costplus.online/v1/orders/Manualne Base64 kodovanie
Ak preferujete zostavit hlavicku sami, najprv zakodujte kluc:
echo -n "YOUR_API_KEY:" | base64Potom zadajte zakodovanu hodnotu v hlavicke Authorization:
curl -H "Authorization: Basic YOUR_BASE64_ENCODED_KEY" https://api.costplus.online/v1/orders/Konciaca dvojbodka za API klucom je povinna -- oddeluje meno pouzivatela od (prazdneho) hesla v scheme Basic Auth.
HTTP stavove kody
API pouziva standardne HTTP stavove kody na oznacenie vysledku poziadavky.
| Stavovy kod | Vyznam | Popis |
|---|---|---|
| 200 | OK | Poziadavka bola uspesna. |
| 201 | Vytvorene | Zdroj bol uspesne vytvoreny. |
| 400 | Chybna poziadavka | Poziadavka bola nespravne formatovana alebo chybaju povinne polia. |
| 401 | Neautorizovane | Autentifikacia zlyhala -- skontrolujte svoj API kluc. |
| 403 | Zakazane | Nemate opravnenie pristupovat k tomuto zdroju. |
| 404 | Nenajdene | Pozadovany zdroj neexistuje. |
| 500 | Interna chyba servera | Nieco sa pokazilo na nasej strane. |
| 502 | Chybna brana | Chyba upstreamovej sluzby. |
| 503 | Sluzba nedostupna | API je docasne nedostupne. |
| 504 | Casovy limit brany | Upstreamova sluzba neodpovedala vcas. |