API:Data formats/tr

Giriş
API, girişini HTTP isteği tarafından sağlanan  veya   biçimindeki parametreler aracılığıyla alır. Her modülün ve alt modülün, belgelerde ve action=help içinde listelenen kendi parametre seti vardır. Ayrıca aracılığıyla da alınabilirler.

Kodlama
Tüm girişler UTF-8, NFC biçiminde geçerli olmalıdır. MediaWiki, bir hatayla sonuçlanabilecek diğer biçimleri dönüştürmeye çalışır.

Çoklu değerli parametreler
Birden çok değer alan parametreler normalde dikey çizgi karakteri kullanılarak ayrılmış değerlerle gönderilir, ör. . Bir değer kendi içinde boru karakterini içeriyorsa, ayırıcı olarak U+001F (Birim Ayırıcı) kullanın ve değerin önüne U+001F ekleyin, ör. .

Bir parametrenin birden fazla değeri kabul edip etmemesi modül belgelerinde açıkça listelenir.

Boole parametreleri
Bir HTTP isteğinde bir boolean parametresi belirtilirse, değerinden bağımsız olarak doğru kabul edilir. Yanlış bir değer için parametreyi tamamen atlayın. Bir HTTP isteğinde gerçek bir parametre belirtmenin en iyi yolu ; sondaki , tarayıcının veya HTTP kütüphanesinin "boş" someParam atmamasını sağlar.

Zaman damgaları
Zaman damgası değerleri alan parametreler birden çok zaman damgası biçimini kabul eder:


 * ISO 8601 biçimi:.
 * MySQL'in dahili zaman damgası biçimi:.
 * UNIX zaman damgası biçimi  (1 Ocak 1970'ten bu yana geçen saniye sayısı).
 * UNIX zaman damgası biçimi  (1 Ocak 1970'ten bu yana geçen saniye sayısı).

Zaman damgaları her zaman ISO 8601 biçiminde çıkarılır.

Çıkış
MediaWiki'deki standart ve varsayılan çıktı biçimi JSON'dur. Diğer tüm biçimler önerilmez.

Çıkış biçimi her zaman  kullanılarak belirtilmelidir ve yourformat aşağıdakilerden biri olur:

Yanıt
Aksi belirtilmedikçe, tüm modüller tüm genel biçimlerde veri çıkışına izin verir. Hata ayıklamayı basitleştirmek için, tüm genel biçimler  sonekiyle "pretty-print in HTML" alternatiflerine sahiptir, ör. .

JSON parametreleri
Aşağıdaki parametreler  ve   ile kullanılabilir:



Ek notlar

 * XML ve PHP çıktı biçimleri kullanımdan kaldırılmıştır, ancak kullanımdadır. PHP ile yazılmış istemciler temelde güvensiz olduğu için PHP biçimini kullanmaktan kaçınmalıdır. It is maintained for now only due to its popularity.
 * There are many conversion libraries and online converters to convert JSON responses to other formats—for example, JSON-CSV converts to Comma-Separated Values.
 * Feed modules like Feed Recent Changes override the standard output format, instead using RSS or Atom, as specified by their  parameter. In those cases, the format specified in the   parameter is only used if there's an error.