MasterBase® API
Učte sa z našich rozhraní API
Ak chcete vytvoriť adresu URL služby, ktorú chcete využívať, musíte použiť nasledujúcu štruktúru:
Základná adresa URL zoskupujúca webové služby:
https://api2023.masterbase.com
do ktorého musíte najprv pridať segment označujúci službu, na ktorú odkazuje, a potom nepovinné parametre, ktoré definujú príslušný dotaz. Prvému z nich predchádza otáznik (?), za ktorým nasleduje znak rovnosti (=) a hodnota parametra. Od druhého parametra, ktorý potrebujete pridať, musíte namiesto otáznika použiť znak ampersand (&).
Príklad:
https://api2023.masterbase.com/contacts/v2/ClientName/?Od=123&Top=100&Order=1
Štruktúra
Obálka
Každá odpoveď je obsiahnutá v štruktúre nazývanej obálka (obálka, obal). To znamená, že každá odpoveď má vopred definovanú štruktúru, s ktorou môže komunikovať.
{
"Service": "Názov služby",
"Version": "Verzia služby",
"TransactionId": "Alfanumerický identifikátor transakcie",
"Status": {
Code": "Kód odpovede", "Code": "Kód odpovede", "Value": "Hodnota odpovede",
"Value": "Hodnota odpovede", "Value": "Hodnota odpovede".
},
"Data": {}
}
Stav
Kľúč stav sa používa na získanie informácií o odozve služby. Ak všetko prebehlo správne, odpoveď bude v atribúte Code uvádzať hodnotu 200 alebo 201. Môže sa však stať, že sa niečo pokazí, a v takom prípade dostanete odpoveď tohto typu:
"Stav": {
"Kód": "401",
"Value": "Unauthorized"
}
Overovanie
Na využívanie webových služieb dostupných na tejto stránke je potrebné vziať do úvahy, že autentifikácia prístupu je základná a na tento účel sa používajú poverenia API - používateľ a heslo - ktoré získate prostredníctvom svojho účtu MasterBase®. Ich použitie bude závisieť od jazyka zvoleného na konzumáciu služieb a je na zodpovednosti používateľa.
Prístup k príručke spotreby rozhrania API MasterBase®
Kontakty - Správa kontaktov
API, ktoré umožňuje synchronizovať údaje o kontaktoch uložené vo vašich interných systémoch s údajmi z vašich databáz v MasterBase®.
MassiveMail - Spravujte svoje zásielky
API, ktoré vám umožňuje vytvárať správy a hromadné rozosielanie bez prihlásenia do platformy MasterBase®.
UniqueMail - Spravujte svoje jedinečné zásielky
API, ktoré umožňujú uskutočňovať jednorazové zásielky z interných systémov bez potreby prihlásenia sa do platformy MasterBase®.
Archív - ukladanie jednotlivých kampaní na adresu URL
Rozhranie API na nahrávanie a sťahovanie súborov do a z cloudu MasterBase® na hromadné odosielanie
Config - Zobrazenie konfiguračných údajov
API na získanie informácií z polí každej databázy.
Prístup k rozhraniu API MasterBase® pre automatizáciu procesov
Automatizácia procesov - WS RDS
Rozhranie API umožňujúce vzdialenú správu záznamov v kolekcii údajov RDS.
Automatizácia - WS File Bunker
API, ktoré umožňuje ukladanie súborov vo webovom prostredí.