ユーザーメールアドレスAPI

ユーザーアカウントのメールアドレスを操作するために、このAPIを使用します。詳細については、ユーザーアカウントを参照してください。

すべてのメールアドレスを一覧表示

あなたのユーザーアカウントのすべてのメールアドレスを一覧表示します。

前提条件:

• 認証済みである必要があります。

GET /user/emails

レスポンス例:

[
  {
    "id": 1,
    "email": "email@example.com",
    "confirmed_at": "2021-03-26T19:07:56.248Z"
  },
  {
    "id": 3,
    "email": "email2@example.com",
    "confirmed_at": null
  }
]

ユーザーのすべてのメールアドレスを一覧表示

指定したユーザーアカウントのすべてのメールアドレスを一覧表示します。

前提条件:

• インスタンスへの管理者アクセス権が必要です。

GET /users/:id/emails

サポートされている属性は以下のとおりです:

メールアドレスの詳細を取得する

あなたのユーザーアカウントの指定したメールアドレスの詳細を取得します。

GET /user/emails/:email_id

サポートされている属性は以下のとおりです:

レスポンス例:

{
  "id": 1,
  "email": "email@example.com",
  "confirmed_at": "2021-03-26T19:07:56.248Z"
}

メールアドレスを追加

あなたのユーザーアカウントにメールアドレスを追加します。

POST /user/emails

サポートされている属性は以下のとおりです:

{
  "id": 4,
  "email": "email@example.com",
  "confirmed_at": "2021-03-26T19:07:56.248Z"
}

成功した場合、ステータス201 Createdで作成されたメールを返します。エラーが発生した場合は、エラーを説明するメッセージと共に400 Bad Requestが返されます:

{
  "message": {
    "email": [
      "has already been taken"
    ]
  }
}

ユーザーのメールアドレスを追加

指定したユーザーアカウントにメールアドレスを追加します。

前提条件:

• インスタンスへの管理者アクセス権が必要です。

POST /users/:id/emails

サポートされている属性は以下のとおりです:

メールアドレスを削除

あなたのユーザーアカウントのメールアドレスを削除します。プライマリメールアドレスを削除することはできません。

削除されたメールアドレスに今後送信されるすべてのメールは、代わりにプライマリメールアドレスに送信されます。

前提条件:

• 認証済みである必要があります。

DELETE /user/emails/:email_id

サポートされている属性は以下のとおりです:

戻り値:

• 操作が成功した場合、204 No Content。
• リソースが見つからなかった場合は404。

ユーザーのメールアドレスを削除

指定したユーザーアカウントのメールアドレスを削除します。プライマリメールアドレスを削除することはできません。

前提条件:

• インスタンスへの管理者アクセス権が必要です。

DELETE /users/:id/emails/:email_id

サポートされている属性は以下のとおりです: