Autentifikacija
Saznajte kako se autentificirati s Cost+ API-jem
Sva komunikacija s Cost+ API-jem zahtijeva TLS 1.2 ili noviji i HTTP Basic autentifikaciju.
Kako funkcionira Basic Auth
Autentificirajte se koristeći svoj API ključ kao korisničko ime s praznom lozinkom. Base64-kodirajte niz \{api_key\}: (obratite pozornost na dvotočku na kraju — lozinka je prazna).
Rezultirajuće Authorization zaglavlje izgleda ovako:
Authorization: Basic aHVudGVyMjo=Nikada ne izlažite svoj API ključ u klijentskom kodu ili javnim repozitorijima. Čuvajte ga isključivo na strani poslužitelja.
Korištenje cURL-a
Ugrađena podrška (preporučeno)
cURL nativno podržava Basic Auth putem -u zastavice. Proslijedite svoj API ključ nakon kojeg slijedi dvotočka:
curl -u YOUR_API_KEY: https://api.costplus.online/v1/orders/Ručno Base64 kodiranje
Ako želite sami konstruirati zaglavlje, prvo kodirajte ključ:
echo -n "YOUR_API_KEY:" | base64Zatim proslijedite kodiranu vrijednost u Authorization zaglavlju:
curl -H "Authorization: Basic YOUR_BASE64_ENCODED_KEY" https://api.costplus.online/v1/orders/Dvotočka na kraju API ključa je obavezna — odvaja korisničko ime od (prazne) lozinke u Basic Auth shemi.
HTTP statusni kodovi
API koristi standardne HTTP statusne kodove za označavanje rezultata zahtjeva.
| Statusni kod | Značenje | Opis |
|---|---|---|
| 200 | OK | Zahtjev je uspio. |
| 201 | Stvoreno | Resurs je uspješno stvoren. |
| 400 | Neispravan zahtjev | Zahtjev je bio neispravan ili mu nedostaju obavezna polja. |
| 401 | Neautorizirano | Autentifikacija nije uspjela — provjerite svoj API ključ. |
| 403 | Zabranjeno | Nemate dozvolu za pristup ovom resursu. |
| 404 | Nije pronađeno | Traženi resurs ne postoji. |
| 500 | Interna greška poslužitelja | Nešto je pošlo po krivu na našoj strani. |
| 502 | Loš pristupnik | Greška uzvodne usluge. |
| 503 | Usluga nedostupna | API je privremeno nedostupan. |
| 504 | Istek pristupnika | Uzvodna usluga nije odgovorila na vrijeme. |