За да съставите URL адреса на услугата, която искате да използвате, трябва да следвате следната структура:

Базов URL адрес, обединяващ уеб услугите:

към която трябва да добавите, на първо място, сегмента, който посочва услугата, към която се отнася, а след това допълнителните параметри, които определят конкретния ви запитване. Първият от тях трябва да започва с въпросителен знак (?), последван от знак за равенство (=) и стойността на параметъра. От втория параметър, който трябва да добавите, трябва да използвате знака амперсанд (&) вместо въпросителния знак.

Пример:

Структура

Пликът

Всеки отговор е съдържан в структура, наречена „envelope“ (плик, обвивка). Това означава, че всеки отговор има предварително дефинирана структура, с която може да се взаимодейства.

{
  "Service": "Име на услугата",
  "Version": "Версия на услугата",
  "TransactionId": "Алфанумеричен идентификатор на транзакцията",
  "Status": {
    "Code": "Код на отговора",
    "Value": "Стойност на отговора"
  },
  "Data": {}
}

Статус

Ключът статус се използва за получаване на информация относно отговора на услугата. Ако всичко е протекло правилно, отговорът ще посочи в атрибута Код стойността 200 или 201. Въпреки това може да възникне проблем, в който случай ще получите отговор от този тип:

{
  "Статус": {
    "Код": "401",
    "Стойност": "Неоторизиран"
  }
}

Удостоверяване

За да използвате уеб услугите, предлагани на този сайт, трябва да имате предвид, че аутентификацията за достъп е базова и за тази цел се използват API данните за достъп — потребителско име и парола — които се получават чрез вашия акаунт в MasterBase®.

Използването им зависи от езика, избран за ползване на услугите, и е отговорност на лицето, което ги ползва.