Щоб сформувати URL-адресу сервісу, яким ви хочете скористатися, слід дотримуватися такої структури:

Базова URL-адреса, що групує веб-сервіси:

до якого спочатку слід додати сегмент, що вказує на службу, до якої звертається запит, а потім — опціональні параметри, що визначають конкретний запит. Перший із них повинен йти після знака питання (?), за яким слідує знак рівності (=) та значення параметра. Починаючи з другого параметра, який вам потрібно додати, слід використовувати знак амперсанд (&) замість знака питання.

Приклад:

Структура

Конверт

Кожна відповідь міститься в структурі, яка називається «envelope» (конверт, обгортка). Це означає, що кожна відповідь має заздалегідь визначену структуру, з якою можна взаємодіяти.

{
  "Service": "Назва служби",
  "Version": "Версія служби",
  "TransactionId": "Алфавітно-цифровий ідентифікатор транзакції",
  "Status": {
    "Code": "Код відповіді",
    "Value": "Значення відповіді"
  },
  "Data": {}
}

Статус

Ключ статус використовується для отримання інформації про відповідь служби. Якщо все пройшло правильно, у відповіді в атрибуті буде вказано Код значення 200 або 201. Однак може статися, що щось піде не так, і в такому випадку відповідь буде такою:

{
  "Status": {
    "Code": "401",
    "Value": "Не авторизовано"
  }
}

Аутентифікація

Для використання веб-сервісів, доступних на цьому сайті, слід врахувати, що аутентифікація доступу є базовою, і для цього використовуються облікові дані API — ім’я користувача та пароль, — які можна отримати через ваш обліковий запис MasterBase®.

Використання цих даних залежатиме від мови, обраної для користування послугами, і відповідальність за це несе той, хто користується цими послугами.