ドメインの所有検証開始 (POST /)
指定したドメインを送信元IDとして登録し、ドメインを所有していることを確認するための検証手続きを開始します。
レスポンスのVerificationTokenの値を、DNSサーバのTXTレコードに設定することで、検証手続きが完了します。
ドメインの所有が確認できると、個々にメールアドレスを検証しなくても、そのドメインに所属するすべてのメールアドレスからのメール送信が可能になります。
Request Headers
「API共通リクエストヘッダー」を参照。
Request Parameter
Action
実行するAPI名。
"VerifyDomainIdentity"
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Version
APIバージョン。
"v1.0"（任意）
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Domain
検証するドメイン。
最大255文字。
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Request Elements
なし
HTTPステータス
ステータス
リクエストのステータスを返却する。
以下の値を返却する。
- 200:
- 正常終了
- 400:
- リクエストのパラメーターエラー
- 401:
- 認証エラー
- 403:
- アクセス拒否
- 500:
- 内部エラー
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
Response Elements（正常終了時）
VerifyDomainIdentityResponse
レスポンスのエンベロープ。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| - | 1..1 | None | VerifyDomainIdentityResult
ResponseMetadata |
VerifyDomainIdentityResult
結果のエンベロープ。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| - | 1..1 | VerifyDomainIdentityResponse | VerificationToken |
VerificationToken
検証トークン。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | VerifyDomainIdentityResult | None |
ResponseMetadata
メタデータのエンベロープ。
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| - | 1..1 | VerifyDomainIdentityResponse | RequestId |
RequestId
リクエストを一意に識別するID。
問題が発生した場合の問い合わせの際にトラブルシューティングを行うために必要です。
UUID形式 例：647cd254-e0d1-44a9-af61-1d6d86ea6b77
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| xsd:string | 1..1 | ResponseMetadata | None |
Example of Request
POST / HTTP/1.1
Date: Fri, 06 Jun 2014 11:00:37 GMT
Content-Length: …
Host: mail.jp-east-1.tps5.fujitsu.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8
X-Auth-Token: MIIFvgY…
Action=VerifyDomainIdentity
&Domain=example.com
Example of Response
HTTP/1.1 200 OK
Date: Fri, 06 Jun 2014 11:00:38 GMT
Content-Length: …
Content-Type: application/xml
x-fj-request-id: 0610909f-2598-4354-838b-67223520e3ea
<?xml version="1.0" encoding="UTF-8"?>
<VerifyDomainIdentityResponse>
<VerifyDomainIdentityResult>
<VerificationToken>95f2f6b80985…</VerificationToken>
</VerifyDomainIdentityResult>
<ResponseMetadata>
<RequestId>0610909f-2598-4354-838b-67223520e3ea</RequestId>
</ResponseMetadata>
</VerifyDomainIdentityResponse>