MediaWiki API yardımı

Bu otomatik olarak oluÅturulan bir MediaWiki API belgelenme sayfasÄ±dÄ±r.

Belgeler ve Ã¶rnekler: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

Ana modÃ¼l

Kaynak: MediaWiki
Lisans: GPL-2.0-or-later

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.

Parametre:

action

Eylemin gerÃ§ekleÅtirileceÄi.

advancedmeta-tasks: AdvancedMeta iÃ§in silme ve dÃ¼zenleme gibi iÅlemler saÄlar
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.
edit: Sayfa oluÅturun ve dÃ¼zenleyin.
emailuser: Bir kullanÄ±cÄ±ya e-posta gÃ¶nderin.
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.
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.
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: SpamBlacklist'e karÅÄ± bir veya daha fazla URL doÄrulayÄ±n.
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.
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 dÃ¼zeltmelerini geri yÃ¼kleyin.
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.
mobileview: KaldÄ±rÄ±ldÄ±. Mobil gÃ¶rÃ¼nÃ¼mler iÃ§in gerekli verileri 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.
stashedit: Dahili. PaylaÅÄ±lan Ã¶nbellekte bir dÃ¼zenleme hazÄ±rlayÄ±n.

AÅaÄÄ±daki deÄerlerden biri: advancedmeta-tasks, block, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, compare, createaccount, delete, edit, emailuser, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, help, imagerotate, import, linkaccount, login, logout, managetags, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setnotificationtimestamp, setpagelanguage, spamblacklist, tag, templatedata, titleblacklist, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, webapp-manifest, mobileview, categorytree, cspreport, stashedit

VarsayÄ±lan: help

format

ÃÄ±kÄ±ÅÄ±nÄ±n biÃ§imi.

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Ä±).

AÅaÄÄ±daki deÄerlerden biri: json, jsonfm, none, php, phpfm, rawfm, xml, xmlfm

VarsayÄ±lan: jsonfm

maxlag

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.

TÃ¼r: tamsayÄ±

smaxage

s-maxage HTTP Ã¶nbellek kontrolÃ¼ Ã¼stbilgisini bu kadar saniye olarak ayarlayÄ±n. Hatalar asla Ã¶nbelleÄe alÄ±nmaz.

TÃ¼r: tamsayÄ±

VarsayÄ±lan: 0

maxage

max-age HTTP Ã¶nbellek kontrolÃ¼ Ã¼stbilgisini bu kadar saniye olarak ayarlayÄ±n. Hatalar asla Ã¶nbelleÄe alÄ±nmaz.

TÃ¼r: tamsayÄ±

VarsayÄ±lan: 0

assert

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.

AÅaÄÄ±daki deÄerlerden biri: anon, bot, user

assertuser

GeÃ§erli kullanÄ±cÄ±nÄ±n adlandÄ±rÄ±lmÄ±Å kullanÄ±cÄ± olduÄunu doÄrulayÄ±n.

Åunu yazÄ±n: kullanÄ±cÄ±, herhangi biri kullanÄ±cÄ± adÄ±

requestid

Burada verilen herhangi bir deÄer yanÄ±ta dahil edilecektir. Ä°stekleri ayÄ±rt etmek iÃ§in kullanÄ±labilir.

servedby

Ä°steÄi sunan ana bilgisayar adÄ±nÄ± sonuÃ§lara ekleyin.

TÃ¼r: boole (ayrÄ±ntÄ±lar)

curtimestamp

GeÃ§erli zaman damgasÄ±nÄ± sonuca dahil et.

TÃ¼r: boole (ayrÄ±ntÄ±lar)

responselanginfo

SonuÃ§ta uselang ve errorlang iÃ§in kullanÄ±lan dilleri ekleyin.

TÃ¼r: boole (ayrÄ±ntÄ±lar)

origin

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.

uselang

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.

VarsayÄ±lan: user

variant

Dilin varyantÄ±. YalnÄ±zca temel dil, deÄiÅken dÃ¶nÃ¼ÅtÃ¼rmeyi destekliyorsa Ã§alÄ±ÅÄ±r.

errorformat

UyarÄ± ve hata metni Ã§Ä±kÄ±ÅÄ± iÃ§in kullanÄ±lacak biÃ§im

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.

AÅaÄÄ±daki deÄerlerden biri: bc, html, none, plaintext, raw, wikitext

VarsayÄ±lan: bc

errorlang

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.

VarsayÄ±lan: uselang

errorsuselocal

Verilirse, hata metinleri MediaWiki ad alanÄ±ndan yerel olarak Ã¶zelleÅtirilmiÅ iletiler kullanÄ±r.

TÃ¼r: boole (ayrÄ±ntÄ±lar)

Ãrnekler:

Ana modÃ¼l iÃ§in yardÄ±m.: api.php?action=help [sandbox'ta aÃ§Ä±n]
Hepsi tek bir sayfada yardÄ±m.: api.php?action=help&recursivesubmodules=1 [sandbox'ta aÃ§Ä±n]

Ä°zin:

writeapi: Yazma API'sini kullan; Kabul edildi: all, user ve bot
apihighlimits: API sorgularÄ±nda daha yÃ¼ksek sÄ±nÄ±rlar kullanÄ±n (yavaÅ sorgular: 500; hÄ±zlÄ± sorgular: 5000). YavaÅ sorgulama sÄ±nÄ±rlarÄ± Ã§ok deÄerli parametreler iÃ§in de geÃ§erlidir.; Kabul edildi: bot ve sysop

Veri tÃ¼rleri

MediaWiki'ye giriÅ, NFC normalleÅtirilmiÅ UTF-8 olmalÄ±dÄ±r. MediaWiki diÄer girdileri dÃ¶nÃ¼ÅtÃ¼rmeye Ã§alÄ±Åabilir, ancak bu MD5 denetimleriyle bazÄ± iÅlemlerin (dÃ¼zenlemeler gibi) baÅarÄ±sÄ±z olmasÄ±na neden olabilir.

Birden Ã§ok deÄer alan parametreler normalde dikey Ã§izgi karakteri kullanÄ±larak ayrÄ±lmÄ±Å deÄerlerle gÃ¶nderilir; param=value1|value2 veya param=value1%7value2. Bir deÄerin boru karakterini iÃ§ermesi gerekiyorsa, ve ayÄ±rÄ±cÄ±sÄ± olarak U+001F (Birim AyÄ±rÄ±cÄ±) kullanÄ±n. Ã¶r. param=%1Fvalue1%1Fvalue2.

API isteklerindeki bazÄ± parametre tÃ¼rlerinin daha fazla aÃ§Ä±klanmasÄ± gerekir:

boolean: Boole parametreleri HTML onay kutularÄ± gibi Ã§alÄ±ÅÄ±r: parametre belirtilirse, deÄerine bakÄ±lmaksÄ±zÄ±n doÄru kabul edilir. YanlÄ±Å bir deÄer iÃ§in parametreyi tamamen atlayÄ±n.
expiry: Vade sonu deÄerleri gÃ¶receli (Ã¶r. 5 months veya 2 weeks) veya kesin (Ã¶r. 2014-09-18T12:34:56Z). BitiÅi olmayan iÃ§in, infinite, indefinite, infinity veya never kullanÄ±n.
timestamp: Zaman damgalarÄ± birkaÃ§ biÃ§imde belirtilebilir; ayrÄ±ntÄ±lar iÃ§in mediawiki.org'da belgelenen Zaman DamgasÄ± kÃ¼tÃ¼phane giriÅ biÃ§imlerine bakÄ±n. ISO 8601 tarih ve saat Ã¶nerilir: 2001-01-15T14:56:00Z. AyrÄ±ca, geÃ§erli zaman damgasÄ±nÄ± belirtmek iÃ§in now dizesi kullanÄ±labilir.

Åablonlu parametreleri

GeÃ§ici parametreler, bir API modÃ¼lÃ¼nÃ¼n baÅka bir parametrenin her deÄeri iÃ§in bir deÄere ihtiyaÃ§ duyduÄu durumlarÄ± destekler. ÃrneÄin, meyve istemek iÃ§in bir API modÃ¼lÃ¼ varsa, hangi meyvelerin talep edildiÄini belirtmek iÃ§in fruits parametresine ve {fruit}-quantity her meyveden kaÃ§ tane talep edileceÄini belirtin. Daha sonra 1 elma, 5 muz ve 20 Ã§ilek isteyen bir API istemcisi fruits=apples|bananas|strawberries&apples-quantity=1&bananas-quantity=5&strawberries-quantity=20 gibi bir istekte bulunabilir.

KatkÄ±da bulunanlar

API geliÅtiricileri:

Yuri Astrakhan (yaratÄ±cÄ±, baÅ geliÅtirici EylÃ¼l 2006 â EylÃ¼l 2007)
Roan Kattouw (Ã¶ncÃ¼ geliÅtirici EylÃ¼l 2007â2009)
Victor Vasiliev
Bryan Tong Minh
Sam Reed
Brad Jorsch (Ã¶ncÃ¼ geliÅtirici 2013 â gÃ¼nÃ¼mÃ¼z)

LÃ¼tfen yorumlarÄ±nÄ±zÄ±, Ã¶nerilerinizi ve sorularÄ±nÄ±zÄ± [email protected] adresine gÃ¶nderin. veya https://phabricator.wikimedia.org/ adresinde bir hata raporu sunun.

MediaWiki API yardımı

Ana modÃ¼l

Veri tÃ¼rleri

Åablonlu parametreleri

KatkÄ±da bulunanlar

Åablonlu parametreleri