Cost+Docs

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 with -u flag
curl -u YOUR_API_KEY: https://api.costplus.online/v1/orders/

Ručno Base64 kodiranje

Ako želite sami konstruirati zaglavlje, prvo kodirajte ključ:

Encode the API key
echo -n "YOUR_API_KEY:" | base64

Zatim proslijedite kodiranu vrijednost u Authorization zaglavlju:

cURL with manual Authorization header
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 kodZnačenjeOpis
200OKZahtjev je uspio.
201StvorenoResurs je uspješno stvoren.
400Neispravan zahtjevZahtjev je bio neispravan ili mu nedostaju obavezna polja.
401NeautoriziranoAutentifikacija nije uspjela — provjerite svoj API ključ.
403ZabranjenoNemate dozvolu za pristup ovom resursu.
404Nije pronađenoTraženi resurs ne postoji.
500Interna greška poslužiteljaNešto je pošlo po krivu na našoj strani.
502Loš pristupnikGreška uzvodne usluge.
503Usluga nedostupnaAPI je privremeno nedostupan.
504Istek pristupnikaUzvodna usluga nije odgovorila na vrijeme.

On this page