Pentru a construi adresa URL a serviciului pe care dorești să îl utilizezi, trebuie să respecți următoarea structură:

URL de bază care grupează serviciile web:

la care trebuie să adaugi, în primul rând, segmentul care indică serviciul către care se referă și, apoi, parametrii opționali care definesc interogarea respectivă. Primul dintre aceștia trebuie să fie precedat de un semn de întrebare (?), urmat de un semn egal (=) și de valoarea parametrului. Începând cu al doilea parametru pe care trebuie să-l adăugați, trebuie să utilizați semnul ampersand (&) în locul semnului de întrebare.

Exemplu:

Structura

Plicul

Fiecare răspuns este conținut într-o structură numită „envelope” (plic, înveliș). Aceasta înseamnă că fiecare răspuns are o structură predefinită cu care se poate interacționa.

{
  "Service": "Numele serviciului",
  "Version": "Versiunea serviciului",
  "TransactionId": "Identificator alfanumeric al tranzacției",
  "Status": {
    "Code": "Codul răspunsului",
    "Value": "Valoarea răspunsului"
  },
  "Data": {}
}

Stare

Cheia status se utilizează pentru a obține informații despre răspunsul serviciului. Dacă totul a decurs corect, răspunsul va indica în atributul Cod valoarea 200 sau 201. Cu toate acestea, se poate întâmpla ca ceva să nu funcționeze, caz în care răspunsul obținut va fi de genul:

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

Autentificare

Pentru a utiliza serviciile web disponibile pe acest site, trebuie să țineți cont de faptul că autentificarea de acces este de bază și că, în acest scop, se utilizează datele de autentificare API — nume de utilizator și parolă — care se obțin prin intermediul contului dvs. MasterBase®.

Utilizarea acestora va depinde de limba aleasă pentru accesarea serviciilor și este responsabilitatea celui care le accesează.