API:Login/ja

From MediaWiki.org

APIにログインユーザを認識させるために、ログインをしていくつかのトークンを取得しなければなりません。ログイン中はapi.phpへの呼び出しごとに、3つの値を追加の引数として、またはリクエストヘッダ中のクッキーとして渡す必要があります。リクエストの一部としてログイントークンが渡された場合、すべてのクッキーは無視されます。ユーザ名が lgname として渡された場合でも正規化された lgusername として返却されることに注意してください。まず最初に認証をし、その後 lgtoken および lguserid をトークンとしてほかのモジュールの呼び出しに渡してください。

注意 ここやほかの例において、簡便性のためにすべての引数はGETリクエストとして渡されています。あなたのアプリケーションでは、すべてのセキュリティ上注意が必要な引数、また長大な引数はPOSTリクエストとして送信するようにしてください。

リクエスト:
  api.php ? action=login & lgname=Yurik & lgpassword=12345 [& lgdomain=wikipedia.org]
結果:
  api:
    login:
      result: Success         Other values: NoName, Illegal, WrongPluginPass,
                                            NotExists, WrongPass, EmptyPass
      lgtoken: 123ABC         Also returned as a cookie (e.g. enwikiToken)
      lgusername: Yurik       Normalized lgname, 
                              also returned as a cookie (e.g. enwikiUserName)
      lguserid: 12345         Also returned as a cookie (e.g. enwikiUserID)

上記の値を使うには、これらを変更せずに、他の引数に追加してapi.php呼び出しに渡してください。例えばメインページのrollbackトークンを取得する（これは制限された操作です）ためには:

api.php ? action=query & lgtoken=123ABC & lgusername=Yurik & lguserid=23456 
                       & prop=info & intokens=rollback & titles=Main Page

例

http://en.wikipedia.org/w/api.php?action=login&lgname=user&lgpassword=password

重要

セキュリティ上の理由で、このメソッドでは発行制限が実装されています。ログインに失敗すると、標準のSpecial:Userlogin経由で認証するか、このモジュールで再びログインを試みる前に60秒待つ必要があります。この制限はmemcacheがサポートされたサーバに置いて有効です。