メインコンテンツまでスキップ

ResetUserPassword

パスワード初期化リクエスト（ワークスペース管理者）

Description​

  • ワークスペース管理者が対象のユーザに対してパスワード変更を依頼します。
  • システムに固有のSendgridメールテンプレートを利用する場合は、事前にHexabase社へ必要事項を連絡します。Hexabase社より発行されたemail_templates_idを指定することで、独自のSendgridメールテンプレートを利用することができます。
  • Sendgrid以外のメールサービスを扱いたい場合は、こちら をご確認ください。

Method​

POST

Request URL Format​

/api/v0/users/password/reset

Payload​

{
  "email":"パスワードをリセットしたいユーザーのemail",　//必須
  "user_code": "パスワードをリセットしたいユーザーのuser_code", // (任意) 同一emailが登録されていてユーザーを一意に特定できない場合必要になります
  "sender_address": "[email protected]", // (任意) メールのfromアドレスを任意の値に変更したい場合に指定します
  "sender_name": "Hexabase", // (任意) メールのfrom名前を任意の値に変更したい場合に指定します
  "host": "",  //(任意) メール内のリンク先URLに利用するホスト名を指定します。省略するとHexabase管理UIが指定されます。 実装例= `https://${window.location.host}` (SPA UI内に用意されたページへ遷移する場合) email_templates_idを指定した場合、必須となります。
  "root_path":  "(reset_password に相当する部分のURL内のパス)" ,  // （任意） 
  "query_params": "(一意キーの後続くGETパラメータを指定)",  // （任意）  ? より後を指定する
  "email_templates_id" : "5fb205b03545feade82dxxxx",  // （任意）招待メールを送信する際にお客様用のSendgridテンプレートを使用する場合に設定します。事前にHexabase社へ必要事項を連絡し、Hexabase社より発行されたemail設定IDを指定します。 省略するとHexabaseのデフォルトのパスワード変更画面が利用されます。
  "exclusive_w_id": "624bea3a879f4e8d8b5dcc6c" // （任意）対象がワークスペース限定ユーザの場合に対象のワークスペースIDを指定します
}
{
  "email":"パスワードをリセットしたいユーザーのemail",　//必須
  "new_password":"", // 必須　新規作成パスワード　例：test
  "confirm_password":"",  //必須　確認用パスワード 例：test この値は新規作成の値と同じでなければならない
  "id":"",  //必須　パスワード初期化開始のapi送信後にemailのリンク内部に埋め込まれた情報をここに入れる
  "send_password_to_email": true  // API実行時に登録完了メールを送信する。デフォルト false
  "sender_address": "[email protected]" // 登録完了メールのfromを任意の値に変更したい場合に指定します
}

PayloadとEメール内のURL Sample​

Request URL Sample​

POST https://api.xxx.com/api/v0/users/password/reset
  • default
{
  "email": "[email protected]"
}

送信されたEメールに生成されるリンクが示すリダイレクト先 (xxxxxx... は一時的に生成されるユニークID)

https://app.hexabase.com/reset_password/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

例えば、以下のように指定した場合、

{
  "email": "[email protected]",
  "host": `https://${window.location.host}`,
  "root_path":  "pwd_reset" ,
  "query_params": "param1=AAA&param2=BBB"
}

リダイレクト先は、以下のように変化します (フロントエンドAPPのhost名がmyapp.sample-spa.comだった場合)

https://myapp.sample-spa.com/pwd_reset/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx?param1=AAA&param2=BBB

これにより、パスワードリセット画面に必要なパラメータを渡す事が可能となります。

Response Sample​

{
  "valid_email": true //パスワード初期化をしたいemailの有無
}

ResetUserPassword (Sendgrid以外のメールサービス利用例)​

  • 標準で送信されるメールについて、フラグを指定することで送信しないよう設定できます

Payload​

{
  "email":"パスワードをリセットしたいユーザーのemail",　//必須
  "exclusive_w_id": "624bea3a879f4e8d8b5dcc6c", // （任意）対象がワークスペース限定ユーザの場合に対象のワークスペースIDを指定します
  "no_confirm_email": true // true指定でHexabase標準のSendgridメールが送信されなくなります
}

Response Sample​

  • no_confirm_email: trueとした場合、リクエストに対応したconfirmation_idが返却されます
  • 返却されたconfirmation_idをSetNewPassword のidに使用できます
{
  "confirmation_id": "0vsr2g46q3xuxrx8clg638668d7qacpx9azjl960l07orv31ar3e3yo4lv32iimedye09grwetqubnfbti7nrnsnm6o9ey6fqweo",
  "valid_email": true //パスワード初期化をしたいemailの有無
}