API на MasterBase®
Учете се от нашите API
Какво представляват приложните програмни интерфейси на MasterBase® и за какво служат?
Удостоверения за API: Защо да ги създаваме и как да го правим
За да конструирате URL адреса на услугата, която искате да използвате, трябва да го направите със следната структура:
Базов URL адрес, обединяващ уеб услугите:
https://api2023.masterbase.com
към който първо трябва да добавите сегмента, указващ услугата, към която сочи, и след това незадължителните параметри, които определят въпросната заявка. Първият от тях е предшестван от въпросителен знак (?), последван от знак за равенство (=) и стойността на параметъра. От втория параметър, който трябва да добавите, трябва да използвате знака амперсанд (&) вместо въпросителния знак.
Пример::
https://api2023.masterbase.com/contacts/v2/ClientName/?От=123&Top=100&Order=1
Структура
Пликът
Всеки отговор се съдържа в структура, наречена плик (плик, опаковка). Това означава, че всеки отговор има предварително определена структура, с която може да взаимодейства.
{
"Service": "Service name",
"Версия": "Версия на услугата",
"TransactionId": "Буквено-цифров идентификатор на транзакцията",
"Status": {
Код": "Код на отговора", "Код": "Код на отговора", "Стойност": "Стойност на отговора",
"Стойност": "Стойност на отговора", "Стойност": "Стойност на отговора
},
"Данни": {}
}
Статус
Ключът статус се използва за получаване на информация за отговора на услугата. Ако всичко е протекло правилно, отговорът ще посочи в атрибута Code стойността 200 или 201. Може обаче да се случи нещо да се обърка, като в този случай отговорът, който ще получите, е от този тип:
"Статус": {
"Код": "401",
"Value": "Unauthorized"
}
Удостоверяване
За използването на уеб услугите, налични на този сайт, е необходимо да се има предвид, че удостоверяването на достъпа е основно и за тази цел се използват API идентификатори - потребител и парола - които се получават чрез вашия MasterBase® акаунт. Използването им зависи от езика, избран за потреблението на услугите, и е отговорност на потребителя.
Достъп до ръководството за употреба на приложните програмни интерфейси на MasterBase®
Контакти - Управлявайте контактите си
API, който дава възможност за синхронизиране на данните за контакти, съхранявани във вашите вътрешни системи, с тези от вашите бази данни в MasterBase®.
MassiveMail - Управлявайте пощенските си пратки
API, който ви позволява да създавате съобщения и да извършвате масови разпращания, без да влизате в платформата MasterBase®.
UniqueMail - Управлявайте уникалните си писма
API, които позволяват извършването на еднократни доставки от вътрешни системи, без да е необходимо да се влиза в платформата MasterBase®.
Архив - съхранение на отделни кампании на URL адрес
API за качване и изтегляне на файлове към и от облака MasterBase® за масови разпращания
Config - Преглед на данните за конфигурацията
API за получаване на информация от полетата на всяка база данни.
Достъп до приложните програмни интерфейси на MasterBase® за автоматизация на процеси
Автоматизация на процесите - WS RDS
API, позволяващ дистанционно управление на записи в колекция от данни RDS.
Автоматизация - WS File Bunker
API, който позволява съхраняването на файлове в уеб среда.