APIリファレンス

URLおよびフォーマットは以下のようになります。

       
URL     http://dozens.jp/api
Format   JSON
Accept Header   application/json
拡張子   .json

※現在はJSONフォーマットのみ提供しております。


Request

Dozensにログイン後、プロフィールページのAPI Keyの値をX-Auth-KeyにDozensIDをX-Auth-Userにいれて送信。

GET /api/authorize.json HTTP/1.1  
Host: dozens.jp  
X-Auth-User: dozens  
X-Auth-Key: a8753098B73131kewt987612004957d89  

Response

認証に成功した場合、1日間有効なtokenを発行します。
また、全ての操作はauth_tokenをもとに認証されます。
未認証の場合、HTTPコード401を返却します。その場合は再度認証を行って下さい。

{"auth_token":"6cfb3debbbac7d144e9eb7b701f79c2225bd6646 "}  

各種APIの操作に必要な共通ヘッダーです。認証後のauth_tokenを使用して下さい。

GET /api/zone.json HTTP/1.1
Host: dozens.jp
Content-Type: application/json
X-Auth-Token:6cfb3debbbac7d144e9eb7b701f79c2225bd6646

※ゾーンリスト取得の場合


GET http://dozens.jp/api/zone.json

Response
id: 一意なゾーンのID
name: ゾーン名

Sample

{"domain":
    [
        {"id":"2","name":"dnzdns.com"},
        {"id":"1","name":"dozens.jp"}
    ]
}

POST http://dozens.jp/api/zone/create.json

Request

       
name ゾーン名
add_google_apps true or false / GoogleAppsのレコードを追加する場合はtrue
google_authorize TXTによってGoogleAppsの確認をする場合は設定
mailaddress SOA用のメールアドレス、指定がない場合はユーザー登録のメールアドレスを使用します。
{
     "name": "dozens.jp",
     "add_google_apps": true,
     "google_authorize": "google_comfirm_txt_record"
     "mailaddress": "domain@dozens.jp"
}

Response
ゾーンリストを返却します。「ゾーン(ドメイン)リストの取得」と同内容




GET http://dozens.jp/api/record/{zone_name}.json

zone_name ゾーン名 ex) dozens.jp

Response

       
id 一意なレコードのID
name レコード名
type A / AAAA / CNAME / MX / TXT / SRV / ALIAS
prio プライオリティー
ttl 60 or 3600 or 7200 or 86400 (無料アカウント、miniプランの場合: 7200固定)
{
"record":
[
    {"id":"1","name":"www.dozens.jp","type":"A","prio":null,"content":"192.168.1.80","ttl":"7200"},
    {"id":"2","name":"ghost_cname_auth.dozens.jp","type":"CNAME","prio":null,"content":"ghs.google.com","ttl":"7200"},
    {"id":"4","name":"dozens.jp","type":"MX","prio":"10","content":"ASPMX.L.GOOGLE.COM","ttl":"7200"},
    {"id":"11","name":"dozens.jp","type":"TXT","prio":null,"content":"v=spf1 include:_spf.google.com ~all","ttl":"7200"}
]
}

POST http://dozens.jp/api/record/create.json

Request

       
domain ゾーン(ドメイン)名
name レコード名
type A / AAAA / CNAME / MX / TXT / SRV / ALIAS
prio プライオリティー
content
ttl 60 or 900 or 3600 or 7200 or 86400 (無料アカウント、miniプランの場合: 7200からの変更は不可)
{
     "domain": "dozens.jp",
     "name": "www",
     "type": "A",
     "prio": 10,
     "content": "192.168.1.10",
     "ttl": "7200"
}

Response
レコードリストを返却します。「レコードリストの取得」と同内容



POST http://dozens.jp/api/record/update/{record_id}.json

record_id : レコードID

Request

       
prio プライオリティー
content
ttl 60 or 3600 or 7200 or 86400 (無料アカウント、miniプランの場合: 7200からの変更は不可)
{
     "prio": 10,
     "content": "192.168.1.10",
     "ttl": "7200"
}

Response

レコードリストを返却します。「レコードリストの取得」と同内容