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. Şimdilik sadece popülaritesi nedeniyle korunuyor.
 * JSON yanıtlarını diğer biçimlere dönüştürmek için birçok dönüştürme kitaplığı ve çevrimiçi dönüştürücüler vardır. Örneğin, JSON-CSV Virgülle Ayrılmış Değerler.
 * Son Değişiklikler Beslemesi gibi besleme modülleri,  parametresinde belirtildiği gibi RSS veya Atom yerine standart çıkış biçimini geçersiz kılar. Bu durumlarda,   parametresinde belirtilen biçim yalnızca bir hata olması durumunda kullanılır.



Ayrıca bakınız

 * - Uyarı ve hata biçimleri içerir.