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