Chcete-li vytvořit URL služby, kterou chcete využívat, musíte použít následující strukturu:

Základní adresa URL seskupující webové služby:

k němuž musíš nejprve přidat část označující službu, na kterou odkazuje, a poté volitelné parametry, které definují daný dotaz. První z nich musí být za znakem otazníku (?), následovaným znakem rovnítka (=) a hodnotou parametru. Od druhého parametru, který potřebujete přidat, musíte místo otazníku použít znak ampersand (&).

Příklad:

Struktura

Obálka

Každá odpověď je obsažena ve struktuře zvané „envelope“ (obálka, obal). To znamená, že každá odpověď má předdefinovanou strukturu, se kterou lze pracovat.

{
  "Service": "Název služby",
  "Version": "Verze služby",
  "TransactionId": "Alfanumerický identifikátor transakce",
  "Status": {
    "Code": "Kód odpovědi",
    "Value": "Hodnota odpovědi"
  },
  "Data": {}
}

Stav

Klíč stav slouží k získání informací o odpovědi služby. Pokud vše proběhlo správně, bude v atributu uvedeno Kód hodnota 200 nebo 201. Může se však stát, že dojde k chybě, a v takovém případě bude odpověď vypadat takto:

{
  "Status": {
    "Code": "401",
    "Value": "Unauthorized"
  }
}

Ověřování

Při využívání webových služeb dostupných na tomto webu je třeba vzít v úvahu, že ověřování přístupu je základní a k tomuto účelu se používají přihlašovací údaje k API – uživatelské jméno a heslo –, které lze získat prostřednictvím vašeho účtu MasterBase®.

Jejich použití bude záviset na jazyku, který si uživatel zvolí pro využívání služeb, a zodpovědnost za to nese ten, kdo tyto služby využívá.