ユーザーAPI/ユーザーパスワードリセット
名称 | ユーザーパスワードリセット |
---|---|
APIバージョン | 1 |
認証タイプ | クライアント認証 |
URL | https://(APIサーバー名)/services/api/(アクセスコード)/ |
Method | POST |
データ形式 | application/x-www-form-urlencoded |
モバイルダイエットのユーザーパスワードをリセットし、新しいパスワードを自動発行する。
引数名 | 値 | 型 | 必須 | 内容 |
v | 1(固定) | int定数 | 必須 | バージョン番号 現在は1 |
c | Bn(固定) | string定数 | 必須 | コマンド Bn = BBAPIを呼び出す |
Category | URG(固定) | string定数 | 必須 | オペレーションカテゴリー URG = コーポレートアカウントマネージャー |
Operation | rst(固定) | string定数 | 必須 | オペレーション rak = RESETAUTHKEYオペレーション |
AppKey | アプリケーションキー | string | 必須 | アプリケーションキーペアのアプリケーションキー |
IDseed | 認証シード | string | 必須 | 認証に使う毎回変わるランダムの文字列 |
IDval | 認証ハッシュ値 | hash | 必須 | sha1(アプリケーションシークレット+認証シード)の値 |
uid | モバイルダイエットID | string | uidまたはloginidのいずれか必須 | ユーザーのモバイルダイエットID |
loginid | ログインID | string | uidまたはloginidのいずれか必須 | ユーザーのログインID |
Format | json,yaml,xml | string定数 | 任意 | 出力フォーマット指定 省略時json(またはアプリケーションキー毎に指定のフォーマット) |
Charset | UTF-8,SJIS,EUC-JP | string定数 | 任意 | 出力文字コード指定・省略時UTF8 出力フォーマットjson,xml時は常にUTF-8 |
認証パラメーターAppKey,UserAuth,uid,passwordについては、API認証を参照
出力指定パラメーターFormat,Charsetについては、出力フォーマットを参照
変数名 | 型 | 内容 |
api_result | boolean | API実行結果 true:成功 false:失敗 |
api_rescode | integer | API結果コード |
api_reason | string | API結果文字列 |
password | string | リセット後の新しいパスワード |
{ "api_result":true, "api_rescode":1, "password":"hzmayrlp" }
<?xml version="1.0" encoding="UTF-8"?> <response> <api_result>1</api_result> <api_rescode>1</api_rescode> <password>lsmolwfh</password> </response>
PHPサンプル サンプル/PHP/ユーザーAPI/ユーザーパスワードリセット
本APIはユーザー認証を行わずパスワードをリセットするため、セキュリティを考慮して使用すべきである。
ユーザーの操作するクライアントから本機能を実行すべきではない。
本機能は、サーバー側の設定によってアプリーションキー毎に使用を許可するか設定する。充分なセキュリティの考慮がなされているものにのみ許可するべきである。
このドキュメントのバージョン情報
Version | 1 |
Revision | 1 |
Editor | west |