API:Login/ja

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がサポートされたサーバにおいて有効です.