Основна перевага API в MasterBase® полягає в тому, що вони дозволяють автоматизувати дії, які виконуються вручну на веб-платформі.
Серед іншого, вони роблять це можливим:
Оновлюйте свої бази даних у робочому середовищі та на нашій платформі одночасно.
Створюйте та надсилайте повідомлення зі своїх систем без необхідності входу на нашу платформу.
Отримуйте від MasterBase® показники ваших відвантажень
MasterBase® API
Дізнайтеся більше про наші API
Щоб створити URL-адресу сервісу, який ви хочете використовувати, ви повинні зробити це за наступною структурою:
Базова URL-адреса, що групує веб-сервіси:
https://api2023.masterbase.com
до якого спочатку потрібно додати сегмент, що вказує на сервіс, на який він вказує, а потім необов'язкові параметри, які визначають ваш запит, про який йде мова. Першому з них передує знак питання (?), за яким слідує знак рівності (=) і значення параметра. Починаючи з другого параметра, який потрібно додати, ви повинні використовувати знак амперсанду (&) замість знака питання.
Приклад:
https://api2023.masterbase.com/contacts/v2/ClientName/?Від=123&Top=100&Замовлення=1
Структура
Конверт
Кожна відповідь міститься в структурі, яка називається конверт (конверт, обгортка). Це означає, що кожна відповідь має наперед визначену структуру, з якою вона може взаємодіяти.
{
"Service": "Назва сервісу",
"Version": "Версія сервісу",
"TransactionId": "Буквено-цифровий ідентифікатор транзакції",
"Status": {
"Code": "Код відповіді", "Code": "Код відповіді", "Value": "Значення відповіді",
"Value": "Значення відповіді", "Value": "Значення відповіді", "Value": "Значення відповіді
},
"Data": {}
}
Статус
Ключ статус використовується для отримання інформації про відповідь сервісу. Якщо все пройшло правильно, відповідь буде мати в атрибуті Code значення 200 або 201. Однак може статися так, що щось пішло не так, і в цьому випадку ви отримаєте відповідь такого типу:
"Status": {
"Code": "401",
"Value": "Unauthorized"
}
Аутентифікація
Для користування веб-сервісами, доступними на цьому сайті, необхідно враховувати, що автентифікація доступу є базовою, і для цього використовуються облікові дані API - ім'я користувача та пароль, які отримуються через ваш обліковий запис MasterBase®. Їх використання залежить від мови, обраної для користування послугами, і є відповідальністю користувача.