MasterBase® API
Lær af vores API'er
API-legitimationsoplysninger: Hvorfor oprette dem, og hvordan man gør det
For at konstruere URL'en til den service, du ønsker at bruge, skal du gøre det med følgende struktur:
Basis-URL, der grupperer webtjenesterne:
https://api2023.masterbase.com
som du først skal tilføje det segment, der angiver den tjeneste, den peger på, og derefter de valgfrie parametre, der definerer din forespørgsel. Den første af disse indledes med et spørgsmålstegn (?), efterfulgt af et lighedstegn (=) og værdien af parameteren. Fra den anden parameter, du skal tilføje, skal du bruge ampersand-tegnet (&) i stedet for spørgsmålstegnet.
Eksempel:
https://api2023.masterbase.com/contacts/v2/ClientName/?Fra=123&Top=100&Ordre=1
Struktur
Konvolutten
Hvert svar er indeholdt i en struktur kaldet konvolut (konvolut, indpakning). Det betyder, at hvert svar har en foruddefineret struktur, som det kan interagere med.
{
"Tjeneste": "Navn på tjeneste",
"Version": "Version af tjenesten",
"TransactionId": "Alfanumerisk transaktions-id",
"Status": {
Code": "Response code", "Code": "Response code", "Value": "Value of the response",
"Værdi": "Svarets værdi", "Værdi": "Svarets værdi
},
"Data": {}
}
Status
Nøglen status bruges til at få oplysninger om tjenestens svar. Hvis alt er forløbet korrekt, vil svaret i Code-attributten angive værdien 200 eller 201. Det kan dog ske, at noget går galt, og i så fald er det svar, du får, af denne type:
"Status": {
"Kode": "401",
"Value": "Unauthorized" (uautoriseret)
}
Autentificering
For at bruge de webtjenester, der er tilgængelige på dette websted, er det nødvendigt at overveje, at adgangsgodkendelse er grundlæggende, og til dette formål bruges API-legitimationsoplysninger - bruger og adgangskode - som fås via din MasterBase®-konto. Brugen af disse vil afhænge af det sprog, der er valgt til brug af tjenesterne, og er brugerens ansvar.
Adgang til MasterBase® API'ernes forbrugsguide
Kontakter - Administrer dine kontakter
API, der gør det muligt at synkronisere de kontaktdata, der er gemt i dine interne systemer, med dine databaser i MasterBase®.
MassiveMail - Administrer dine forsendelser
API, der giver dig mulighed for at oprette beskeder og lave masseudsendelser uden at logge ind på MasterBase®-platformen.
UniqueMail - Administrer dine unikke forsendelser
API'er, der gør det muligt at foretage enkeltstående forsendelser fra interne systemer uden at skulle logge ind på MasterBase®-platformen.
Arkiv - URL-lagring af individuelle kampagner
API til upload og download af filer til og fra MasterBase®-skyen til masseforsendelser
Config - Se konfigurationsdata
API for at få oplysninger fra felterne i hver database.
Få adgang til MasterBase® API'er til procesautomatisering
Procesautomatisering - WS RDS
API, der muliggør fjernadministration af poster i en RDS-datasamling.
Automatisering - WS File Bunker
API, der gør det muligt at gemme filer i et webmiljø.