Principalul avantaj al API-urilor din MasterBase® este că acestea permit automatizarea acțiunilor care sunt efectuate manual pe platforma web.
Printre altele, ele fac acest lucru posibil:
Actualizați-vă bazele de date simultan în mediul de lucru și pe platforma noastră.
Creați și trimiteți mesaje din sistemele dvs. fără a fi nevoie să vă conectați la platforma noastră.
Primiți de la MasterBase® măsurătorile dvs. de expediere
MasterBase® API
Învățați din API-urile noastre
Ce sunt API-urile MasterBase® și la ce servesc acestea?
Pentru a construi URL-ul serviciului pe care doriți să îl consumați, trebuie să faceți acest lucru cu următoarea structură:
URL de bază care grupează serviciile web:
https://api2023.masterbase.com
la care trebuie să adăugați mai întâi segmentul care indică serviciul către care se îndreaptă și apoi parametrii opționali care definesc interogarea în cauză. Primul dintre aceștia este precedat de un semn de întrebare (?), urmat de un semn egal (=) și de valoarea parametrului. De la al doilea parametru pe care trebuie să îl adăugați, trebuie să utilizați semnul ampersandă (&) în locul semnului de întrebare.
Exemplu:
https://api2023.masterbase.com/contacts/v2/ClientName/?De la=123&Top=100&Ordine=1
Structura
Plicul
Fiecare răspuns este conținut într-o structură numită plic (plic, învelitoare). Acest lucru înseamnă că fiecare răspuns are o structură predefinită cu care poate interacționa.
{
"Service": "Numele serviciului",
"Version": "Versiunea serviciului",
"TransactionId": "Identificatorul alfanumeric al tranzacției",
"Status": {
"Code": "Cod": "Cod de răspuns", "Code": "Cod de răspuns", "Value": "Valoarea răspunsului",
"Value": "Valoarea răspunsului", "Value": "Valoarea răspunsului
},
"Data": {}
}
Stare
Cheia status este utilizat pentru a obține informații despre răspunsul serviciului. Dacă totul s-a desfășurat corect, răspunsul va indica în atributul Code valoarea 200 sau 201. Cu toate acestea, se poate întâmpla ca ceva să meargă prost, caz în care răspunsul pe care îl veți primi este de acest tip:
"Status": {
"Code": "401",
"Value": "Unauthorized"
}
Autentificare
Pentru consumul serviciilor web disponibile pe acest site, este necesar să aveți în vedere că autentificarea accesului este de bază, iar în acest scop sunt utilizate credențiale API -utilizator și parolă- care se obțin prin intermediul contului dumneavoastră MasterBase®. Utilizarea acestora va depinde de limba aleasă pentru consumul serviciilor și este responsabilitatea utilizatorului.