Kullanmak İstediğiniz Hizmetin URL'sini Oluşturmak İçin Aşağıdaki Yapıyı Kullanmalısınız:

Web hizmetlerini gruplayan temel URL:

Buna öncelikle, hedeflediği hizmeti belirten segmenti ve ardından söz konusu sorgunuzu tanımlayan isteğe bağlı parametreleri eklemeniz gerekir. Bunlardan ilki bir soru işareti (?) ile başlamalı, ardından bir eşittir işareti (=) ve parametrenin değeri gelmelidir. Eklemeniz gereken ikinci parametreden itibaren, soru işareti yerine ampersand (&) işareti kullanmalısınız.

Örnek:

Yapı

Zarf

Her yanıt, “envelope” (zarf, ambalaj) adı verilen bir yapı içinde yer alır. Bu, her yanıtın etkileşim kurulabilecek önceden tanımlanmış bir yapıya sahip olduğu anlamına gelir.

{
  "Service": "Hizmet adı",
  "Version": "Hizmet sürümü",
  "TransactionId": "Alfanümerik işlem kimliği",
  "Status": {
    "Code": "Yanıt kodu",
    "Value": "Yanıt değeri"
  },
  "Data": {}
}

Durum

Anahtar durum Hizmetin yanıtı hakkında bilgi edinmek için kullanılır. Her şey doğru şekilde ilerlediyse, yanıtta şu öznitelik belirtilecektir: Kod 200 veya 201 değeri. Ancak, bir hata meydana gelebilir; bu durumda alınacak yanıt şu şekilde olacaktır:

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

Kimlik Doğrulama

Bu sitede sunulan web hizmetlerinden yararlanmak için, erişim kimlik doğrulamasının temel düzeyde olduğunu göz önünde bulundurmak gerekir; bu amaçla, MasterBase® hesabınız aracılığıyla elde ettiğiniz API kimlik bilgileri (kullanıcı adı ve şifre) kullanılır.

Bunların kullanımı, hizmetlerin tüketimi için seçilen dile bağlı olacaktır ve bu, söz konusu tüketimi gerçekleştiren kişinin sorumluluğundadır.