API dokumentacija

Za developere.

Promjena statusa ponude

Ova metoda ti omogućuje promjenu statusa postojeće ponude. Imaj na umu da možeš mijenjati status samo u Otvori, Plaćeno ili Odbaci. Promjena statusa u plaćeno neće automatski kreirati račun.

Pozivanje metode se vrši putem ove adrese:

POST https://api.solo.com.hr/status

Parametri

Parametri predstavljaju naredbe koje šalješ u POST pozivu.

token

Tvoj tajni identifikator. Možeš pronaći svoj API token u Postavkama nakon prijave u servis.

Pravilo: obavezno

id

ID ponude koji je vidljiv kod prikaza ponude.

Pravilo: obavezno

status

Željeni status ponude. Ovdje provjeri podržane statuse računa i ponuda.

Pravilo: obavezno, numerički unos

Povratne informacije

Ovdje su navedeni mogući odgovori servisa nakon što pošalješ API zahtjev.

Odgovor na uspješan zahtjev će biti ovakav:

{
  "status": 0,
  "ponuda": {
    "id": "8791cae3c9b02bb8d88bf626247b4e67dfbe20e35fc0342b448f39c9264c591d",
    "broj_ponude": "0001-2026",
    "status": "5",
    "boja": "#a9bf15",
    "stari_status": "1"
  },
  "message": "Status ponude _0001-2026_ promijenjen."
}
          

Popis mogućih grešaka kod neispravnog zahtjeva:

101 Neispravan token.
122 Dokument ne postoji.
150 ID dokumenta nije poslan.
160 Nedozvoljeni status.
161 Status nije poslan ili u neispravnom formatu.
429 Previše zahtjeva. Smanji učestalost spajanja na API servis (max. 100 zahtjeva u 60 minuta).