Če želite sestaviti URL-naslov storitve, ki jo želite uporabiti, morate upoštevati naslednjo strukturo:

Osnovni URL, ki združuje spletne storitve:

kateremu moraš najprej dodati segment, ki označuje storitev, na katero se nanaša, nato pa izbirne parametre, ki opredeljujejo zadevno poizvedbo. Prvi parameter mora biti ločen z vprašajem (?), ki mu sledi znak enakovrednosti (=) in vrednost parametra. Od drugega parametra naprej, ki ga želite dodati, morate namesto vprašaja uporabiti znak ampersand (&).

Primer:

Struktura

Ovojnica

Vsak odgovor je vsebovan v strukturi, imenovani »envelope« (kuverta, ovoj). To pomeni, da ima vsak odgovor vnaprej določeno strukturo, s katero je mogoče interagirati.

{
  "Service": "Ime storitve",
  "Version": "Različica storitve",
  "TransactionId": "Alfanumerični identifikator transakcije",
  "Status": {
    "Code": "Koda odgovora",
    "Value": "Vrednost odgovora"
  },
  "Data": {}
}

Status

Ključ status se uporablja za pridobivanje informacij o odzivu storitve. Če je vse potekalo pravilno, bo odziv v atributu navedel Koda vrednost 200 ali 201. Vendar se lahko zgodi, da pride do napake, v tem primeru pa bo odgovor izgledal takole:

{
  "Status": {
    "Code": "401",
    "Value": "Neavtorizirano"
  }
}

Preverjanje pristnosti

Za uporabo spletnih storitev, ki so na voljo na tej spletni strani, je treba upoštevati, da je avtentifikacija dostopa osnovna in da se za to uporabljajo API-pristopni podatki – uporabniško ime in geslo –, ki jih pridobite prek svojega računa MasterBase®.

Njihova uporaba je odvisna od jezika, izbranega za uporabo storitev, in je v odgovornosti tistega, ki te storitve uporablja.