ConoHa API Documantation

メール転送先一覧取得 - Mail API v1.0

Description
メール転送設定情報を取得します。

Request URL

Mail API v1.0

GET /v1/forwarding

Request Paramters

Parameter Value Style Type Description
X-Auth-Token - header string Userトークン
offset(Optional) - query int 取得開始位置、Default:0
limit(Optional) - query int 取得数、Default:1000
sort_key(Optional) create_date/address query string ソートキー、Default:create_date
sort_type(Optional) asc/desc query string ソート順、Default:asc

Response Paramters

Parameter Value Style Type Description
forwarding - - list -
email_id - plain UUID メールID
forwarding_id - plain UUID 転送先メールID
address - plain string 転送先メールアドレス
total_count - plain int 全体件数
current_count - plain int 抽出件数

Request Json

This operation does not accept a request body.

Normal response codes

200 - Success

Error response codes

401 - Access Denied
404 - Not Found

Repeatable

Yes

Example
※エンドポイントURLにつきましては、お客様環境によって異なりますので、コントロールパネルにてご確認の上ご利用ください。

  • REQ
curl -i -X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: 39be9f8d53044388b7f2e867eba8b140" \
https://mail-hosting.tyo1.conoha.io/v1/forwarding?email_id=508bb370c78b7a
  • RES
HTTP/1.1 200 Success
Date: Tue, 09 Dec 2014 01:46:58 GMT
Server: Apache
Content-Length: 1003
Content-Type: application/json

{
    "forwarding": [
        {
            "email_id": "508bb370c78b7a",
            "forwarding_id": "28e50414998f0ba",
            "address": "forward01@example.com"
        },
        {
            "email_id": "508bb370c78b7a",
            "forwarding_id": "p5a742zyidxgr5f",
            "address": "forward02@example.com"
        },
        {
            "email_id": "508bb370c78b7a",
            "forwarding_id": "ldz9ycw1dzqo4kh",
            "address": "forward03@example.com"
        }
    ],
    "total_count":100,
    "current_count":10
}