Osnovni URL i okruženja

API ima jedan host. Svaki zahtev ide na https://api.morffeus.com/api/v2 i putanju endpointa, preko HTTPS-a, sa JSON-om u oba smera.

Osnovni URL#

curl -X PUT "https://api.morffeus.com/api/v2/int/stocks" \
  -H "Authorization: Bearer $MORFFEUS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "stocks": [ … ] }'

Zahtevi#

• HTTPS. Vaš token putuje u zaglavlju, zato nikad ne šaljite zahtev preko običnog HTTP-a.
• JSON telo. Svako telo zahteva šaljite kao JSON uz Content-Type: application/json. Bez tog zaglavlja telo se ne čita i poziv prolazi kao da telo niste poslali.
• Accept. Izostavite zaglavlje ili pošaljite application/json. Vrednost koja isključuje JSON dobija odgovor 406.
• Nazivi. Parametri upita su uglavnom u camelCase obliku, na primer warehouseId. Polja u telu zahteva su u snake_case obliku, na primer warehouse_code. Stranica svakog endpointa navodi svoje.

Odgovori#

• JSON, UTF-8. Sadržaj je pod data, greške su pod errors. Izuzetke opisuje stranica Greške.
• Brojevi. Količine i cene su JSON brojevi i mogu imati decimale. Naši identifikatori su celi brojevi.
• Vreme. Vremenske oznake su u UTC-u, u ISO 8601 obliku, bez pomaka: 2026-09-30T09:41:12.
• Content-Type. Neki odgovori sa greškom stižu bez tog zaglavlja. Telo čitajte kao JSON bez obzira na to šta zaglavlje kaže.

Test okruženje#

Da biste razvijali i testirali bez diranja živih podataka, zatražite test aplikaciju na [email protected]. Dogovorićemo je sa vama, uključujući gde šaljete zahteve i kako dobijate token za nju.

Povezano#

• Autentifikacija: token koji nosi svaki zahtev.
• Vaš prvi zahtev: osnovni URL u praksi.
• Greške: statusni kodovi i tela grešaka.