API:Login/ja
From MediaWiki.org
| このページは MediaWiki API ドキュメントの一部です。 |
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
- 重要
- セキュリティ上の理由で、このメソッドでは発行制限が実装されています。ログインに失敗すると、標準のSpecial:Userlogin経由で認証するか、このモジュールで再びログインを試みる前に60秒待つ必要があります。この制限はmemcacheがサポートされたサーバに置いて有効です。

