MediaWiki API yardımı
Bu, otomatik olarak oluşturulmuş bir MediaWiki API belgeler sayfasıdır.
Genel bilgiler
Status: The MediaWiki API is a mature and stable interface that is actively supported and improved. While we try to avoid it, we may occasionally need to make breaking changes; subscribe to the mediawiki-api-announce mailing list for notice of updates.
Erroneous requests: When erroneous requests are sent to the API, an HTTP header will be sent with the key "MediaWiki-API-Error" and then both the value of the header and the error code sent back will be set to the same value. For more information see API: Errors and warnings.
Testing: For ease of testing API requests, see Special:ApiSandbox.
İstek yöntemleri
Eylem API istekleri GET ve POST yöntemlerini kullanabilir. GET yöntemini tercih edin; bu, isteklerin önbelleğe alınmasına olanak tanır.
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 olabilir (ö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ı çeşitli biçimlerde belirtilebilir, ayrıntılar için Zaman damgası kütüphanesi giriş biçimlerine bakın.
Sınırlar
Çoğu API modülü, çok değerli parametrelerde en fazla 50 inputs kabul edebilir ve sorgu başına en fazla 500 results (yavaş sorgular için 50 results) döndürebilir.
apihighlimits hakkına sahip kullanıcılar için ( Botlar, Hizmetliler ve Teknisyenler ), limitler 500 inputs ve 5.000 results (yavaş sorgular için 500 results) olarak artırılır.
Ş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.
Ana modül
- Kaynak: MediaWiki
- Lisans: GPL-2.0-or-later
Specify the action to perform, the format of the response, and options that apply to all API modules.
- action
Hangi işlemin gerçekleştirileceği. Bu parametre, hata ayıklama, analiz ve istek yönlendirme veya filtreleme kolaylığı için istek URL'sinin bir parçası olarak (POST gövdesinde değil) gönderilmelidir.
- 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.
- acquiretempusername
- Geçici bir kullanıcı kullanıcı adı edinin ve geçici hesap oluşturma etkinleştirilmişse ve geçerli kullanıcı oturumdan çıkarılmışsa, geçerli oturumda saklayın. Bir ad zaten saklanmışsa, aynı adı döndürür.
- antispoof
- AntiSpoof'un normalizasyon kontrollerine karşı bir kullanıcı adı kontrol edin.
- block
- Bir kullanıcıyı engelleyin.
- centralauthtoken
- Ekli bir vikiye doğrulanmış bir istekte bulunmak için bir centralauthtoken getirin.
- centralnoticecdncacheupdatebanner
- CDN (ön uç) önbelleğinde depolanan banner içeriğinin anonim kullanıcılar için, istenen banner ve dil için temizlenmesini isteyin
- centralnoticechoicedata
- Belirli bir proje ve dil için bir banner seçmek için gereken verileri alın
- centralnoticequerycampaign
- Bir kampanya için tüm yapılandırma ayarlarını alın.
- 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
hasmsgişaretini temizler. - clientlogin
- Etkileşimli akışı kullanarak viki oturumu açın.
- communityconfigurationedit
- Change the content of a configuration provider in Community configuration
- compare
- İki sayfa arasındaki farkı elde edin.
- createaccount
- Yeni bir kullanıcı hesabı oluşturun.
- createlocalaccount
- Yerel bir hesap oluşturmak zorunludur. Merkezi hesap mevcut olmalıdır.
- cxdelete
- İçerik Çevirisi uzantısı kullanılarak oluşturulan taslak çeviriyi silin.
- cxtoken
- Cxserver ile kimlik doğrulaması yapmak için JWT anahtarlarını alın.
- delete
- Sayfayı silin.
- deleteglobalaccount
- Bir küresel kullanıcıyı silin.
- discussiontoolsedit
- Tartışma sayfasına bir mesaj gönderin.
- discussiontoolsfindcomment
- Bir yorumu kimliğine veya adına göre bulun.
- discussiontoolsgetsubscriptions
- Belirtilen konuların abonelik durumlarını alın.
- discussiontoolssubscribe
- Bir konu hakkında bildirim almak için abone ol (ya da abonelikten çık).
- discussiontoolsthank
- Yorum için herkese açık bir teşekkür bildirimi gönderin.
- echocreateevent
- Manually trigger a notification to a user
- 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.
- editmassmessagelist
- Toplu mesaj teslimat listesini düzenleyin.
- emailuser
- Bir kullanıcıya e-posta gönderin.
- expandtemplates
- Vikimetin içindeki tüm şablonları genişletir.
- featuredfeed
- Özellikli bir içerik besleme verir.
- 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.
- globalblock
- Bir kullanıcıyı küresel olarak engelleyin veya engelini kaldırın.
- globalpreferenceoverrides
- Geçerli kullanıcının genel tercihleri için yerel geçersiz kılmaları değiştirin.
- globalpreferences
- Geçerli kullanıcının genel tercihlerini değiştirin.
- globaluserrights
- Küresel gruplara kullanıcı ekleyin/kaldırın.
- growthmanagementorlist
- Manage information in the structured mentor list (usually stored in MediaWiki:GrowthMentors.json). This module can be used by both current and future mentors (to add themselves or change their details) and administrators (for all users).
- growthmentordashboardupdatedata
- Schedule an extraordinary update of the mentee overview module in the mentor dashboard. You can only schedule one update per two hours for performance reasons.
- growthsetmenteestatus
- Set mentee's status (allows mentees to enable/disable mentorship module, or to opt-out entirely, which deletes the mentee/mentor relationship)
- growthsetmentor
- Kullanıcının danışmanını ayarlayın. Değişiklik herkese açık olarak kaydedilecek.
- growthstarmentee
- Bir danışanı, mevcut kullanıcı tarafından yıldızlı olarak işaretleyin veya işaretini kaldırın (özel olarak saklanır ve günlüğe kaydedilmez)
- help
- Belirtilen modüller için yardımı görüntüleyin.
- homepagequestionstore
- Anasayfa modülleri aracılığıyla yayınlanan biçimlendirilmiş sorular alın
- imagerotate
- Bu modül devre dışı bırakıldı.
- import
- Bir sayfayı başka bir vikiden veya bir XML dosyasından içe aktarın.
- jsonconfig
- JsonConfig alt sistemine doğrudan erişim sağlar.
- languagesearch
- Herhangi bir betikte dil isimlerini arayı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.
- massmessage
- Bir sayfa listesine mesaj gönderin.
- 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.
- setglobalaccountstatus
- Küresel bir kullanıcı hesabını gizle veya kilitle (gizliliğini kaldır veya kilidini aç).
- setnotificationtimestamp
- İzlenen sayfalar için bildirim zaman damgasını güncelleyin.
- setpagelanguage
- Sayfanın dilini değiştirin.
- shortenurl
- Kısa bir URL'ye uzun bir URL kısaltın.
- sitematrix
- Wikimedia siteleri listesini alın.
- spamblacklist
- Bir veya daha fazla URL'yi spam engelleme listesine göre doğrulayın.
- stabilize
- Sayfa kararlılığı ayarlarını değiştirin.
- streamconfigs
- Olay akışı yapılandırmasını gösterir. Yalnızca format=json ile formatversion=2 değerini döndürür.
- strikevote
- Hizmetlilerin oy kullanmasına veya greve gitmesine izin verir.
- sxdelete
- Taslak bölüm çevirisini ve paralel derleme verilerini veritabanından sil.
- 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.
- torblock
- Bir IP adresinin Tor çıkış düğümü olarak engellenip engellenmediğini kontrol edin.
- transcodereset
- 'transcode-reset' hakkına sahip kullanıcılar, bir transkod işini sıfırlayabilir ve yeniden çalıştırabilir.
- 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.
- webauthn
- Kayıt/kimlik doğrulama işlemi sırasında sunucu ile istemci arasında iletişimi sağlayan API Modülü.
- wikilove
- VikiSevgi'sini başka bir kullanıcıya verin.
- bouncehandler
- Dahili. Bir sıçrama e-postası alın ve başarısız alıcıyı ele almak için işleme koyun.
- categorytree
- Dahili. CategoryTree uzantısı için iç modül.
- chartinfo
- Dahili. Mevzut benzersiz Çizelge sayfası kullanım sayısını verir. Aynı sayfada aynı çizelgenin birden fazla kullanımı tek kullanım olarak kabul edilir.
- cirrus-check-sanity
- Dahili. Arama dizinindeki bir dizi sayfa kimliğinin doğruluğunu raporlar
- cirrus-config-dump
- Dahili. CirrusSearch yapılandırmasının dökümü.
- cirrus-profiles-dump
- Dahili. Bu viki için CirrusSearch dökümü profilleri.
- cirrus-schema-dump
- Dahili. Bu viki için CirrusSearch şemasının (ayarlar ve eşlemeler) dökümü.
- codemirror-validate
- Dahili. Verilen içerikteki doğrulama hatalarını kontrol edin
- collection
- Dahili. Bir viki kullanıcısının koleksiyonunda çeşitli işlemler gerçekleştirmek için API 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.
- cxcheckunreviewed
- Dahili. Geçerli kullanıcı için yakın zamanda hızlı, incelenmemiş bir çevirinin yayımlanıp yayımlanmadığını kontrol et.
- cxfavoritesuggestions
- Dahili. Geçerli kullanıcının listesine bir favori öneri ekle veya kaldır.
- cxpublish
- Dahili. İçerik Çevirmeni uzantısıyla yaratılan bir sayfayı kaydedin.
- cxpublishsection
- Dahili. İçerik Çevirisi uzantısının bölüm çeviri özelliğini kullanarak oluşturulan bir bölümü kaydedin.
- cxsave
- Dahili. Bu modül, bant genişliğinden tasarruf etmek ve paralel corpora toplamak için taslak çevirilerin bölümlere göre kaydedilmesini sağlar.
- cxsplit
- Dahili. Verilen makale çevirisinin her çevrilmiş bölümü için veritabanına bir bölüm çevirisi oluştur ve kaydet
- discussiontoolscompare
- Dahili. İki sayfa revizyonu arasındaki yorum değişiklikleri hakkında bilgi alın.
- discussiontoolspageinfo
- Dahili. Tartışma araçlarını başlatmak için gereken meta verileri döndürür.
- discussiontoolspreview
- Dahili. Tarışma sayfasındaki bir mesajı önizleyin.
- echopushsubscriptions
- Dahili. Geçerli kullanıcı için push aboneliklerini yönetin.
- editcheckreferenceurl
- Dahili. Check the status of a URL for use as a reference.
- fancycaptchareload
- Dahili. Yeni bir FancyCaptcha alın.
- growthinvalidateimagerecommendation
- Dahili. Invalidate an image recommendation.
- growthinvalidatepersonalizedpraisesuggestion
- Dahili. Invalidates a suggestion of a praiseworthy mentee in the Personalized praise module on the Mentor dashboard
- growthinvalidaterevisetonerecommendation
- Dahili. Drop a 'Revise Tone' recommendation for a given page.
- helppanelquestionposter
- Dahili. Geçerli kullanıcı için yardım panelinden gönderilen soruları ele alın.
- jsondata
- Dahili. Yerelleştirilmiş JSON verilerini alın.
- jsontransform
- Dahili. Retrieve JSON data transformed by a Lua function.
- parser-migration
- Dahili. Bir sayfayı iki farklı ayrıştırıcı yapılandırmasıyla ayrıştırın.
- readinglists
- Dahili. Okuma listesi yazma işlemleri.
- sanitize-mapdata
- Dahili. Kartographer uzantısı için veri doğrulaması gerçekleştirir
- scribunto-console
- Dahili. Scribunto konsolundan XHR taleplerine hizmet vermek için dahili modül.
- securepollauth
- Dahili. Allows a remote wiki to authenticate users before granting access to vote in the election.
- stashedit
- Dahili. Paylaşılan önbellekte bir düzenleme hazırlayın.
- sxsave
- Dahili. Taslak bölüm çevirisini kaydet ve paralel derleme verilerini depola
- timedtext
- Dahili. <track> öğelerinin kullanımı için zamanlanmış metin içeriği sağlar
- ulslocalization
- Dahili. Verilen dilde ULS yerelleştirmeyi alın.
- ulssetlang
- Dahili. Kullanıcının tercih ettiği arayüz dilini güncelleyin.
- visualeditor
- Dahili. Parsoid hizmetinden bir sayfa için HTML5 değerini döndürür.
- visualeditoredit
- Dahili. Bir HTML5 sayfasını MediaWiki'ye (Parsoid hizmeti aracılığıyla vikimetine dönüştürülür) kaydedin.
- wikimediaeventsblockededit
- Dahili. Log information about blocked edit attempts
- wikimediaeventshcaptchaeditattempt
- Dahili. Log edit diff when hCaptcha challenge is shown but edit is incomplete
- Aşağıdaki değerlerden biri: abusefiltercheckmatch, abusefilterchecksyntax, abusefilterevalexpression, abusefilterunblockautopromote, abuselogprivatedetails, acquiretempusername, antispoof, block, centralauthtoken, centralnoticecdncacheupdatebanner, centralnoticechoicedata, centralnoticequerycampaign, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, communityconfigurationedit, compare, createaccount, createlocalaccount, cxdelete, cxtoken, delete, deleteglobalaccount, discussiontoolsedit, discussiontoolsfindcomment, discussiontoolsgetsubscriptions, discussiontoolssubscribe, discussiontoolsthank, echocreateevent, echomarkread, echomarkseen, echomute, edit, editmassmessagelist, emailuser, expandtemplates, featuredfeed, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, flagconfig, globalblock, globalpreferenceoverrides, globalpreferences, globaluserrights, growthmanagementorlist, growthmentordashboardupdatedata, growthsetmenteestatus, growthsetmentor, growthstarmentee, help, homepagequestionstore, imagerotate, import, jsonconfig, languagesearch, linkaccount, login, logout, managetags, massmessage, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, review, revisiondelete, rollback, rsd, setglobalaccountstatus, setnotificationtimestamp, setpagelanguage, shortenurl, sitematrix, spamblacklist, stabilize, streamconfigs, strikevote, sxdelete, tag, templatedata, thank, titleblacklist, torblock, transcodereset, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, webapp-manifest, webauthn, wikilove, bouncehandler, categorytree, chartinfo, cirrus-check-sanity, cirrus-config-dump, cirrus-profiles-dump, cirrus-schema-dump, codemirror-validate, collection, cspreport, cxcheckunreviewed, cxfavoritesuggestions, cxpublish, cxpublishsection, cxsave, cxsplit, discussiontoolscompare, discussiontoolspageinfo, discussiontoolspreview, echopushsubscriptions, editcheckreferenceurl, fancycaptchareload, growthinvalidateimagerecommendation, growthinvalidatepersonalizedpraisesuggestion, growthinvalidaterevisetonerecommendation, helppanelquestionposter, jsondata, jsontransform, parser-migration, readinglists, sanitize-mapdata, scribunto-console, securepollauth, stashedit, sxsave, timedtext, ulslocalization, ulssetlang, visualeditor, visualeditoredit, wikimediaeventsblockededit, wikimediaeventshcaptchaeditattempt
- Varsayılan: help
- format
Çıkışının biçimi.
- Aşağıdaki değerlerden biri: json, jsonfm, none, 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-maxageHTTP önbellek kontrolü üstbilgisini bu kadar saniye olarak ayarlayın. Hatalar asla önbelleğe alınmaz.- Tür: tamsayı
- Değer, 0 daha az olmamalıdır.
- Varsayılan: 0
- maxage
max-ageHTTP önbellek kontrolü üstbilgisini bu kadar saniye olarak ayarlayın. Hatalar asla önbelleğe alınmaz.- Tür: tamsayı
- Değer, 0 daha az olmamalıdır.
- Varsayılan: 0
- assert
user olarak ayarlanmışsa kullanıcının oturum açtığını (geçici kullanıcı dahil), anon olarak ayarlanmışsa oturum açmadığını veya bot olarak ayarlanmışsa 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ı ve Geçici kullanıcı
- 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
Alanlar arası AJAX isteği (CORS) kullanarak API'ye erişirken, bunu kaynak alan adına ayarlayın. Bu, herhangi bir ön kontrol isteğine dahil edilmelidir ve bu nedenle istek URL'sinin bir parçası olmalıdır (POST gövdesi değil).
Kimliği doğrulanmış istekler için, bu,
Originbaşlığındaki kaynaklardan biriyle tam olarak eşleşmelidir, bu nedenle https://en.wikipedia.org veya https://meta.wikimedia.org gibi bir şeye ayarlanmalıdır. Bu parametreOriginbaşlığıyla eşleşmezse, 403 yanıtı döndürülür. Bu parametreOriginbaşlığıyla eşleşirse ve kaynak izin verilirse,Access-Control-Allow-OriginveAccess-Control-Allow-Credentialsbaşlıkları ayarlanır.Kimliği doğrulanmamış istekler için * değerini belirtin. Bu
Access-Control-Allow-Originbaşlığının ayarlanmasına neden olur, ancakAccess-Control-Allow-Credentialsfalseolur ve tüm kullanıcıya özgü veriler kısıtlanır.- crossorigin
Alanlar arası AJAX isteği (CORS) kullanarak API'ye erişirken ve siteler arası istek sahteciliği (CSRF) saldırılarına karşı güvenli bir oturum sağlayıcısı (OAuth gibi) kullanırken, isteğin kimlik doğrulamalı (yani oturum kapatılmamış) olması için
origin=*yerine bunu kullanın. Bu, herhangi bir ön kontrol isteğine dahil edilmeli ve bu nedenle istek URL'sinin bir parçası olmalıdır (POST gövdesinin değil).Çoğu oturum sağlayıcısının, standart çerez tabanlı oturumlar da dahil olmak üzere, kimlik doğrulamalı CORS'u desteklemediğini ve bu parametreyle kullanılamayacağını unutmayın.
- Tür: boole (ayrıntılar)
- 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)
- centralauthtoken
API'ye bir çapraz alan AJAX isteği (CORS) kullanarak erişirken, geçerli SUL kullanıcısı olarak kimlik doğrulaması yapmak için bunu kullanın. CORS isteğini yapmadan önce, belirteci almak için bu vikide action=centralauthtoken kullanın. Her belirteç yalnızca bir kez kullanılabilir ve 60 saniye sonra süresi dolar. Bu, tüm ön kontrol isteklerine dahil edilmelidir ve bu nedenle istek URI'sine (POST gövdesine değil) dahil edilmelidir.
Bu vikide beklenen değer, MediaWiki önündeki vekil sunucular tarafından doğrulanabilen bir JSON Web Token'dır. Belirtecin süresi dolmuşsa veya başka bir nedenle geçersizse, normal bir API hatasından farklı biçimde bir vekil sunucudan HTTP hatası alabilirsiniz.
- 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&toc [sandbox'ta açın]
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–2020)
Lütfen yorumlarınızı, önerilerinizi ve sorularınızı mediawiki-api@lists.wikimedia.org adresine gönderin. veya https://phabricator.wikimedia.org/ adresinde bir hata raporu sunun.