Yanıt Tipleri

Turkishexportal API 2 farklı biçimde yanıt gönderebilir ;

• XML: Birçok programlama dili ve platformu tarafından kolaylıkla adapte edilebilir.
• JSON: Gerek Javascript içinden eval fonksiyonu ile gerekse birçok programlama dili tarafından kabul görmüş başka bir yanıt tipidir.

Yanıt Tipi Nasıl Belirlenir ?

Alınmak istenen yanıt tipi gönderilen istek içindeki format parametresi ile sağlanır. Bu parameterenin gönderilmediği durumlarda standart olarak JSON tipinde yanıt dönülür. Değiştirilmek istenirse format=xml yada format=json parametresi eklenerek her isteğin yanıt tipi belirlenebilir.

Detaylar

XML

XML yanıtları Turkishexportal tarafından belirlenmiş özel bir XML biçimindedir.

http://www.turkishexportal.com/api/1.0/endpoint?method=city.get&type=xml

<?xml version="1.0" encoding="utf-8"?>
<response timestamp="20091211103940" Count="81">
  <records>
    <row code="01" value="Adana" phone="322" />
    <row code="02" value="Adıyaman" phone="416" />
    <row code="03" value="Afyon" phone="272" />
    <row code="04" value="Ağrı" phone="472" />
    <row code="68" value="Aksaray" phone="382" />
    <row code="05" value="Amasya" phone="358" />
    <row code="06" value="Ankara" phone="312" />
    .
    .
  </records>
</response>

JSON

JSON (JavaScript Object Notation, json.org) basit ve kullanışlı veri bildirim biçimidir. Özellikle tarayıcı içinden kullanılacak Ajax uygulamalarında yoğun biçimde kullanılır.

http://www.turkishexportal.com/api/1.0/endpoint?method=city.get&type=json

Örnek istek - Kesilmiş

{
 "timestamp":"20091211105046",
 "count":"81",
 "records":[
            {"code":"01","value":"Adana","phone":"322"},
            {"code":"02","value":"Adıyaman","phone":"416"},
            {"code":"03","value":"Afyon","phone":"272"},
            {"code":"04","value":"Ağrı","phone":"472"},
            {"code":"68","value":"Aksaray","phone":"382"},
            {"code":"05","value":"Amasya","phone":"358"},
            {"code":"06","value":"Ankara","phone":"312"}
            .
            .
           ]
}