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

action=clientlogin (login)

(main | clientlogin)
  • Bu modül yazma hakları gerektirir.
  • Bu modül yalnızca POST isteklerini kabul eder.
  • Kaynak: MediaWiki
  • Lisans: GPL-2.0-or-later

Etkileşimli akışı kullanarak viki oturumu açın.

Bu modülü kullanmanın genel prosedürü:

  1. action=query+authmanagerinfo üzerinden mevcut alanları amirequestsfor=login ve bir login ile getir action=query&meta=tokens üzerinden anahtar.
  2. Alanları kullanıcıya sunun ve gönderilmesini sağlayın.
  3. Bu modülde loginreturnurl ve ilgili alanları sağlayın.
  4. Yanıttaki status kontrol edin.
    • PASS veya FAIL aldıysanız işleminiz tamamlanmıştır. Operasyon ya başarılı oldu ya da olmadı.
    • UI aldıysanız, yeni alanları kullanıcıya sunun ve gönderilmesini sağlayın. Ardından bu modülde logincontinue ve ilgili alanlar ayarlanmış olarak yayınlayın ve 4. adımı tekrarlayın.
    • REDIRECT aldıysanız, kullanıcıyı redirecttarget yönlendirin ve loginreturnurl dönmesini bekleyin. Ardından bu modülde logincontinue ve dönüş URL'sine iletilen tüm alanlarla yayınlayın ve 4. adımı tekrarlayın.
    • RESTART aldıysanız, kimlik doğrulamanın işe yaradığı, ancak bağlı bir kullanıcı hesabımız olmadığı anlamına gelir. Bunu UI veya FAIL olarak değerlendirebilirsiniz.
Parametre:
loginrequests

Bu kimlik doğrulama isteklerini yalnızca, action=query&meta=authmanagerinfo öğesinden amirequestsfor=login ile veya bu modülün önceki yanıtından döndürülen id ile kullanın.

Değerleri | veya alternatif ile ayırın.
Maksimum değer sayısı 50 (500 için daha yüksek sınırlara izin verilir).
loginmessageformat

Mesajları döndürmek için kullanılacak biçim.

Aşağıdaki değerlerden biri: html, none, raw, wikitext
Varsayılan: wikitext
loginmergerequestfields

Tüm kimlik doğrulama istekleri için alan bilgilerini tek bir dizide birleştirin.

Tür: boole (ayrıntılar)
loginpreservestate

Mümkünse, önceki bir başarısız oturum açma girişiminden durumu koruyun.

Tür: boole (ayrıntılar)
loginreturnurl

Üçüncü taraf kimlik doğrulama akışları için dönüş URL'si mutlak olmalıdır. Ya bu ya da logincontinue gerekli.

Bir REDIRECT yanıtı alındığında, üçüncü taraf bir kimlik doğrulama akışı için genellikle belirtilen redirecttarget URL'sine bir tarayıcı veya web görünümü açarsınız. Bu tamamlandığında, üçüncü taraf tarayıcıyı veya web görünümünü bu URL'ye gönderir. URL'den herhangi bir sorgu veya POST parametresini çıkarmalı ve bunları bu API modülüne logincontinue isteği olarak iletmelisiniz.

logincontinue

Bu istek, daha önceki bir UI veya REDIRECT yanıtından sonra devam ediyor. Ya bu ya da loginreturnurl gerekli.

Tür: boole (ayrıntılar)
logintoken

action=query&meta=tokens üzerinden alınan bir "login" anahtarı

Bu parametre gerekli.
*
Bu modül, mevcut kimlik doğrulama isteklerine bağlı olarak ek parametreleri kabul eder. Belirlemek için action=query&meta=authmanagerinfo ile amirequestsfor=login (veya varsa bu modülden önceki bir yanıt) istekler ve kullandıkları alanlar kullanılabilir.
Örnekler:
Vikide Example parolası ile ExamplePassword kullanıcısı olarak oturum açma işlemini başlatın.
api.php?action=clientlogin&username=Example&password=ExamplePassword&loginreturnurl=http://example.org/&logintoken=123ABC [sandbox'ta açın]
İki faktörlü kimlik doğrulaması için UI yanıtından sonra oturum açmaya devam edin ve 987654 OATHToken sağlayın.
api.php?action=clientlogin&logincontinue=1&OATHToken=987654&logintoken=123ABC [sandbox'ta açın]