Den största fördelen med API:erna i MasterBase® är att de gör det möjligt att automatisera åtgärder som utförs manuellt på webbplattformen.
Det är bland annat de som gör det möjligt:
Uppdatera dina databaser i din arbetsmiljö och på vår plattform samtidigt.
Skapa och skicka meddelanden från dina system utan att behöva logga in på vår plattform.
Ta emot från MasterBase® dina leveransmått
MasterBase® API
Lär dig av våra API:er
För att konstruera URL:en för den tjänst du vill konsumera måste du göra det med följande struktur:
Bas-URL som grupperar webbtjänsterna:
https://api2023.masterbase.com
till vilken du först måste lägga till det segment som anger den tjänst som den pekar på, och sedan de valfria parametrar som definierar din fråga i fråga. Den första av dessa föregås av ett frågetecken (?), följt av ett likhetstecken (=) och parameterns värde. Från den andra parametern som du behöver lägga till måste du använda ampersandtecknet (&) istället för frågetecknet.
Exempel:
https://api2023.masterbase.com/kontakter/v2/Klientnamn/?Från=123&Topp=100&Order=1
Struktur
Kuvertet
Varje svar finns i en struktur som kallas kuvert (kuvert, omslag). Detta innebär att varje svar har en fördefinierad struktur som det kan interagera med.
{
"Tjänst": "Tjänstens namn",
"Version": "Version av tjänsten",
"TransactionId": "Alfanumerisk transaktionsidentifierare",
"Status": {
Kod": "Svarskod", "Kod": "Svarskod", "Värde": "Värde på svaret",
"Värde": "Svarets värde", "Värde": "Svarets värde
},
"Data": {}
}
Status
Nyckeln status används för att få information om tjänstens svar. Om allt har gått rätt till kommer svaret att ange värdet 200 eller 201 i attributet Code. Det kan dock hända att något går fel, och i så fall kommer svaret du får att vara av den här typen:
"Status": {
"Kod": "401",
"Värde": "Obehörig"
}
Autentisering
För att kunna använda de webbtjänster som finns tillgängliga på denna webbplats är det nödvändigt att beakta att autentisering av åtkomst är grundläggande och för detta ändamål används API-referenser - användare och lösenord - som erhålls via ditt MasterBase®-konto. Användningen av dessa beror på vilket språk som valts för användningen av tjänsterna och är användarens ansvar.