API deneme tahtası

MediaWiki web hizmeti API'sini denemek için bu sayfayı kullanın. API kullanımıyla ilgili daha fazla bilgi için API belgelerine bakın. Örnek: belirli bir anahtar kelimeyle eşleşen sayfa başlıkları için arayın. Daha fazla örnek görmek için bir eylem seçin. Bu bir deneme tahtası olmasına rağmen, bu sayfada gerçekleştirdiğiniz işlemlerin vikiyi değiştirebileceğini unutmayın.

main

Durum: MediaWiki API, aktif olarak desteklenen ve geliştirilen olgun ve kararlı bir arayüzdür. Bundan kaçınmaya çalışırken, zaman zaman kırılma değişiklikleri yapmamız gerekebilir; güncellemeleri bildirmek için posta listesine abone olun.

Hatalı istekler: API'ya hatalı istekler gönderildiğinde, "MediaWiki-API-Error" anahtarını içeren bir HTTP başlığı gönderilir ve daha sonra hem başlığın değeri hem de geri gönderilen hata kodu olarak ayarlanır. aynı değer. Daha fazla bilgi için API:Hatalar ve uyarılar sayfasına bakın.

Deneme: API isteklerini test etme kolaylığı için, Special:ApiSandbox sayfasına bakın.

Örnekler

Eylemin gerçekleştirileceği. Genişlet

abusefiltercheckmatch: Bir AbuseFilter'ın bir değişkenler kümesiyle mi, bir düzenleme ile mi yoksa günlüğe kaydedilen bir AbuseFilter olayıyla eşleştiğini kontrol edin.
abusefilterchecksyntax: Bir AbuseFilter filtresinin sözdizimini kontrol edin.
abusefilterevalexpression: Bir AbuseFilter ifadesini değerlendirir.
abusefilterunblockautopromote: Bir kullanıcının kötüye kullanım filtresinin bir sonucu olması nedeniyle otomatik konuşma almasını engeller.
abuselogprivatedetails: Bir AbuseLog girişinin özel ayrıntılarını görüntüleyin.
block: Bir kullanıcıyı engelleyin.
changeauthenticationdata: Geçerli kullanıcı için kimlik doğrulama verilerini değiştirin.
changecontentmodel: Sayfanın içerik modelini değiştirin
checktoken: action=query&meta=tokens üzerinden bir simgenin geçerliliğini kontrol edin.
clearhasmsg: Geçerli kullanıcı için hasmsg işaretini temizler.
clientlogin: Etkileşimli akışı kullanarak viki oturumu açın.
compare: İki sayfa arasındaki farkı elde edin.
createaccount: Yeni bir kullanıcı hesabı oluşturun.
delete: Sayfayı silin.
echomarkread: Bildirimleri geçerli kullanıcı için okundu olarak işaretleyin.
echomarkseen: Bildirimleri geçerli kullanıcı için göründüğü gibi işaretleyin.
echomute: Belirli kullanıcılardan veya sayfalardan gelen bildirimlerin sesini kapatın veya açın.
edit: Sayfa oluşturun ve düzenleyin.
emailuser: Bir kullanıcıya e-posta gönderin.
embedvideo: Verilen parametreler için oluşturulan video yerleştirme kodunu alın.
expandtemplates: Vikimetin içindeki tüm şablonları genişletir.
feedcontributions: Bir kullanıcının katkı yayını döndürür.
feedrecentchanges: Son yapılan değişiklikler özet akışını döndürür.
feedwatchlist: Bir izleme listesi beslemesini döndürür.
filerevert: Bir dosyayı eski bir revizyona geri döndürün.
flagconfig: Bu site için inceleme işareti yapılandırması hakkında temel bilgi edinin.
help: Belirtilen modüller için yardımı görüntüleyin.
imagerotate: Bir veya daha fazla görüntüyü döndürün.
import: Bir sayfayı başka bir vikiden veya bir XML dosyasından içe aktarın.
linkaccount: Bir üçüncü taraf sağlayıcıdan bir hesabı geçerli kullanıcıya bağlayın.
login: Oturum açın ve kimlik doğrulama çerezlerini alın.
logout: Oturumu kapatın ve oturum verilerini temizleyin.
managetags: Değişiklik etiketleriyle ilgili yönetim görevlerini gerçekleştirin.
mergehistory: Sayfa geçmişlerini birleştirin.
move: Bir sayfayı taşı.
opensearch: OpenSearch protokolünü kullanarak vikide arama yapın.
options: Geçerli kullanıcının tercihlerini değiştirin.
paraminfo: API modülleri hakkında bilgi edinin.
parse: İçeriği ayrıştırır ve ayrıştırıcı çıkışını döndürür.
patrol: Bir sayfa veya revizyon devriye edin.
protect: Sayfanın koruma seviyesini değiştirin.
purge: Verilen başlıklar için önbelleği temizleyin.
query: MediaWiki'den ve MediaWiki hakkında veri getirin.
removeauthenticationdata: Geçerli kullanıcı için kimlik doğrulama verilerini kaldırın.
resetpassword: Bir kullanıcıya parola sıfırlama e-postası gönderin.
review: Bir revizyonu onaylayarak veya geri alarak inceleyin.
revisiondelete: Revizyonları silin ve geri alın.
rollback: Sayfadaki son düzenlemeyi geri alın.
rsd: Bir RSD (Gerçekten Basit Keşif) şemasını dışa aktarın.
setnotificationtimestamp: İzlenen sayfalar için bildirim zaman damgasını güncelleyin.
setpagelanguage: Sayfanın dilini değiştirin.
spamblacklist: Bir veya daha fazla URL'yi spam engelleme listesine göre doğrulayın.
stabilize: Sayfa kararlılığı ayarlarını değiştirin.
tag: Tek tek düzeltmelere veya günlük girişlerine değişiklik etiketleri ekleyin veya kaldırın.
templatedata: TemplateData uzantısı tarafından depolanan verileri alın.
thank: Bir editöre teşekkür mesajı gönderin.
titleblacklist: TitleBlacklist ile bir sayfa başlığını, dosya adını veya kullanıcı adını doğrulayın.
unblock: Bir kullanıcının engellemesini kaldırın.
undelete: Silinen bir sayfanın silinmiş revizyonlarını geri getirin.
unlinkaccount: Bağlı bir üçüncü taraf hesabını geçerli kullanıcıdan kaldırın.
upload: Bir dosya yükleyin veya bekleyen yüklemelerin durumunu öğrenin.
userrights: Bir kullanıcının grup üyeliğini değiştirin.
validatepassword: Vikinin parola politikalarına göre bir parola doğrulayın.
watch: Geçerli kullanıcının izleme listesine sayfalar ekleyin veya listeden sayfa kaldırın.
webapp-manifest: Bir web uygulaması bildirimi döndürür.
categorytree: Dahili. CategoryTree uzantısı için iç modül.
cspreport: Dahili. Tarayıcılar tarafından İçerik Güvenliği İlkesi ihlallerini bildirmek için kullanılır. Bu modül, CSP uyumlu bir web tarayıcısı tarafından otomatik olarak kullanıldığı durumlar dışında asla kullanılmamalıdır.
oathvalidate: Dahili. İki faktörlü kimlik doğrulama (OATH) anahtarını doğrulayın.
scribunto-console: Dahili. Scribunto konsolundan XHR taleplerine hizmet vermek için dahili modül.
stashedit: Dahili. Paylaşılan önbellekte bir düzenleme hazırlayın.

Çıkışının biçimi. Genişlet

json: JSON formatında veri çıkışı.
jsonfm: Verileri JSON biçiminde çıktılar (HTML'de güzel baskı).
none: Çıkış yok.
php: Serileştirilmiş PHP biçimde veri çıkışı.
phpfm: Serileştirilmiş PHP biçiminde veri çıkışı (HTML'de güzel baskı).
rawfm: Hata ayıklama öğeleri dahil çıktı verileri, JSON biçiminde (HTML'de güzel yazdırılır).
xml: XML formatında veri çıkışı.
xmlfm: XML biçiminde çıkış (HTML'de güzel baskı).

Maksimum gecikme, MediaWiki veritabanı çoğaltılmış bir kümeye yüklendiğinde kullanılabilir. Daha fazla site çoğaltma gecikmesine neden olan eylemleri kaydetmek için, bu parametre istemcinin çoğaltma gecikmesi belirtilen değerden daha az olana kadar beklemesini sağlayabilir. Aşırı gecikme durumunda, maxlag hata kodu, $host bekleniyor: $lag saniye geçikli gibi bir mesajla birlikte döndürülür.
Daha fazla bilgi için Manual:Maxlag parametresi sayfasına bakınız.

s-maxage HTTP önbellek kontrolü üstbilgisini bu kadar saniye olarak ayarlayın. Hatalar asla önbelleğe alınmaz.

max-age HTTP önbellek kontrolü üstbilgisini bu kadar saniye olarak ayarlayın. Hatalar asla önbelleğe alınmaz.

Kullanıcının user olarak ayarlanmışsa, anon olarak ayarlanmışsa oturum açmamış olduğunu veya bot ise bot kullanıcı hakkına sahip olduğunu doğrulayın.

Geçerli kullanıcının adlandırılmış kullanıcı olduğunu doğrulayın.

Burada verilen herhangi bir değer yanıta dahil edilecektir. İstekleri ayırt etmek için kullanılabilir.

İsteği sunan ana bilgisayar adını sonuçlara ekleyin.

Geçerli zaman damgasını sonuca dahil et.

Sonuçta uselang ve errorlang için kullanılan dilleri ekleyin.

Etki alanları arası AJAX isteği (CORS) kullanarak API'ye erişirken bunu kaynak etki alanına ayarlayın. Bu, uçuş öncesi tüm taleplere dahil edilmeli ve bu nedenle istek URI'sinin bir parçası olmalıdır (POST kuruluşu değil).

Kimliği doğrulanmış istekler için, bunun Origin başlığındaki orijinlerden biriyle tam olarak eşleşmesi gerekir, bu nedenle https://en.wikipedia.org gibi https://meta.wikimedia.org bir şeye ayarlanması gerekir. Bu parametre Origin üstbilgisiyle eşleşmezse, 403 yanıtı döndürülür. Bu parametre Origin üstbilgisiyle eşleşiyorsa ve orijin izin verilirse, Access-Control-Allow-Origin ve Access-Control-Allow-Credentials başlıklar ayarlanacaktır.

Kimliği doğrulanmamış istekler için * değerini belirtin. Bu, Access-Control-Allow-Origin üstbilgisinin ayarlanmasına neden olur, ancak Access-Control-Allow-Credentials, false ve tümü kullanıcıya özgü veriler kısıtlanacaktır.

Mesaj çevirileri için kullanılacak dil. action=query&meta=siteinfo ile siprop=languages bir dil kodu listesi döndürür veya user Mevcut kullanıcının dil tercihini kullanmak için bu vikinin içerik dilini kullanmak için content belirtin.

Dilin varyantı. Yalnızca temel dil, değişken dönüştürmeyi destekliyorsa çalışır.

Uyarı ve hata metni çıkışı için kullanılacak biçim Genişlet

plaintext: HTML etiketlerinin kaldırıldığı ve varlıkların değiştirildiği vikimetin.
wikitext: Ayrıştırılmamış vikimetin.
html: HTML
raw: Mesaj anahtarı ve parametreleri.
none: Metin çıkışı yok, yalnızca hata kodları.
bc: MediaWiki 1.29'dan önce kullanılan biçim. errorlang ve errorsuselocal yoksayılır.

Uyarılar ve hatalar için kullanılacak dil. action=query&meta=siteinfo ile siprop=languages veya content bir dil kodu listesi döndürür. Bu vikinin içerik dilini kullanmak için uselang parametresiyle aynı değeri kullanmak için uselang değerini belirtin.

Verilirse, hata metinleri MediaWiki ad alanından yerel olarak özelleştirilmiş iletiler kullanır.

format=json

JSON formatında veri çıkışı.

Yardım bağlantılarıÖrnekler

Belirtilirse, çıkışı belirli bir işlev çağrısına sarar. Güvenlik için, kullanıcıya özgü tüm veriler kısıtlanacaktır.

Belirtilirse, ASCII olmayan çoğu karakteri onaltılık kaçış dizileriyle değiştirmek yerine UTF-8 olarak kodlar. formatversion 1 olmadığında varsayılan değerdir.

Belirtilirse, onaltılık kaçış dizileri kullanarak tüm ASCII olmayanları kodlar. formatversion 1 olduğunda varsayılan değer.

Çıkış biçimlendirme Genişlet

1: Geriye dönük uyumlu biçim (XML stili booleler, içerik düğümleri için * anahtarları vb.).
2: Modern biçimi.
latest: En son biçimi kullanın (şu anda 2), uyarı yapılmadan değişebilir.