gTLD型ドメイン管理サービスを契約する

API情報

管理権限HTTPメソッドAPI名目的
必要POSTdgjgTLD型ドメイン管理サービスを契約する

gTLD型ドメイン管理サービスを新規契約します。

ご希望のドメイン名が未登録のドメインであることが確認されると、契約が成立し、自動的に株式会社日本レジストリサービス(以下、JPRS)にご希望のドメイン名の登録申請が行われます。

なお、「Registrant.EMailAddress」に登録したメールアドレスに、ご契約が完了した旨のメールが届きます。ご利用開始日は翌日からとなります。

JPRSへのドメイン名の登録が完了したら、ネームサーバの準備と設定を行ってください。gTLD型ドメイン管理サービスは、ご利用中、または新規にお申し込みいただいたDNSアウトソースサービスと連携してご契約いただけます。DNSアウトソースサービスを契約している場合は、ネームサーバの準備と設定については、『DNSアウトソースサービス ご利用の手引き』をご覧ください。

個別パラメータ

URL
フィールド
タイプ
必須
意味
CustomerCodeString

カスタマーコード(例:SG#######)

DomainNameString

契約ドメイン名(例:example.com)

HTTPリクエストボディ
フィールド
タイプ
必須
意味
ContactHash

公開連絡窓口情報のハッシュ

Contact.NameString

公開連絡窓口情報に登録する組織名または個人名

Contact.NameEn

String公開連絡窓口情報に登録する組織名または個人名(英語)
Contact.WebPageString×

公開連絡窓口情報に登録するWebページ

Contact.EMailAddressListArray

公開連絡窓口情報に登録する電子メールアドレス

  • 最大3個登録できます
Contact.PhoneNumberListArray

公開連絡窓口情報に登録する電話番号

  • 最大3個登録できます
Contact.FaxNumberString×

公開連絡窓口情報に登録するFAX番号

Contact.PostalCodeString公開連絡窓口情報に登録する郵便番号
Contact.PrefectureString×

公開連絡窓口情報に登録する都道府県

Contact.PostalAddressListArray×

公開連絡窓口情報に登録する住所

  • 最大3行登録できます
Contact.PostalAddressEnListArray

公開連絡窓口情報に登録する住所(英語)

  • 最大3行登録できます
RegistrantHash

登録者情報及び登録担当者情報のハッシュ

Registrant.NameString登録者情報に登録する組織名または個人名
Registrant.NameEnString登録者情報に登録する組織名または個人名(英語)
Registrant.RepresentativeNameString登録担当者情報に登録する登録担当者名
Registrant.RepresentativeDivisionString×登録担当者情報に登録する登録担当者部署名
Registrant.EMailAddressString登録者情報に登録する電子メールアドレス
Registrant.PhoneNumberString登録者情報に登録する電話番号
Registrant.FaxNumberString×登録者情報に登録するFAX番号
Registrant.PostalCodeString登録者情報に登録する郵便番号
Registrant.PrefectureString

登録者情報に登録する都道府県

Registrant.PostalAddressListArray

登録者情報に登録する住所

  • 最大3行登録できます
Registrant.PostalAddressEnListArray

登録者情報に登録する住所(英語)

  • 最大3行登録できます
DoLinkageTypeString×

DNSアウトソースサービスとの連携フラグ

DoServiceCodeString

連携する既存DNSアウトソースサービスのサービスコード

  • 「DoLinkageType」に「EXISTING_DO」を設定する場合に入力が必要です

レスポンス

フィールドタイプ意味
DgjServiceCodeStringgTLD型ドメイン管理サービスのサービスコード
DoServiceCodeStringDNSアウトソースサービスのサービスコード

エラーコード

ErrorTypeErrorMessage説明備考
ParameterErrorThere are invalid parameters.

以下のパラメータの形式が不正です

  • CustomerCode
  • DomainName
  • Contact
  • Registrant 
  • DoLinkageType
  • DoServiceCode
 
ResourceNotExistResource is not found.

以下のリソースが存在しません

  • DNSアウトソースサービスの契約情報
 
ResourceAlreadyExist

Resource is found.

以下のリソースが既に存在しています

  • ドメイン
  • DNSアウトソースサービスのゾーン

 

Unsupported

Parameter is unsupported.

  • 日本語ドメイン名を設定した場合は、「DoLinkageType」に「DOMAIN_ONLY」を設定してください
  • 契約ドメインが「.org」、または「.info」の場合は、日本語ドメイン名を設定できません
 

制限

お申し込みにあたっての注意事項
  • 他のレジストラ(ドメイン名の登録申請を受け付け、ドメイン名のデータベースへ情報を登録する機関)へのレジストラトランスファー、あるいはご利用予定のISPなどへ指定事業者を変更する場合は、書面で申請してください。DOMAIN-APIでは指定事業者を変更できません。
  • gTLD型ドメイン名の登録に際して、以下の文書の内容をご承諾の上、お申し込みください。
  • ドメイン名の登録及び管理にあたり弊社へご提供いただく情報には、JPRSが必要とする情報を含みます。JPRSが必要とする情報の項目、利用目的などについては、JPRSのWebページをご覧ください。
  • 弊社はJPRSが必要とする情報をJPRSへ提供します。提供した情報の全部または一部は、JPRSのデータベース及びレジストリのデータベースに登録され、一般に公開されます。
  • gTLDで使用できる文字列は、その文字種や文字数に制限があります。詳しくは、以下のWebページをご覧ください。
  • 漢字やひらがなを含む日本語ドメイン名(例:「ドメイン名例.com」)を、URLやメールアドレスのドメイン名として利用するには、各ソフトウェアでの対応が必要です。
  • 弊社はドメイン名の登録取得取り次ぎを受託しますが、JPRSにおける登録申請の受理、及びレジストリにおける登録を意味するものではありません。
  • 弊社は当該ドメイン名に関わる申請内容、及び申請内容によって引き起こされる問題については一切関知しません。万一紛争が生じても、弊社には一切責がないものとします。
  • gTLDの登録にかかる費用として、弊社よりお客様に8,000円を請求します。なお、サービスの初期費用は別途発生します。
  • 当該ドメイン名のgTLD型ドメイン管理サービスの解約後も、当該ドメイン名をご利用いただく場合は、当該ドメイン名の指定事業者またはレジストラを変更してください。解約日の翌々月時点で当該ドメイン名が弊社管理下にある場合は、弊社からJPRSに対し、当該ドメイン名の廃止申請を行います。
連携可能なDNSアウトソースサービスの注意事項
  • DNSアウトソースサービスのみをお申し込みいただく場合は、DO-APIをご利用ください。
  • 同時にお申し込みのgTLD型ドメイン管理サービスと同日にご利用(課金)が開始されます。
  • 最低利用期間は課金開始日より1ヶ月です。最低利用期間内に解約する場合は、調停金を請求します。
  • 日本語ドメイン名をお申し込みいただく場合は、DNSアウトソースサービスとの連携はできません。

サンプル

リクエスト
POST /(CustomerCode)/dgj/(DomainName).json HTTP/1.1
Host: domain.api.iij.jp
Content-Type: application/json
Date: Mon, 20 Jan 2014 12:34:56 GMT
x-iijapi-Expire: (Expire)
x-iijapi-SignatureMethod: (SignatureMethod)
x-iijapi-SignatureVersion: (SignatureVersion)
User-Agent: Mozilla/5.0 (Windows NT 6.1; Trident/7.0; rv:11.0) like Gecko
Authorization: IIJAPI (AccessKeyId):(Signature)
{
    "Contact": {
        "Name": "株式会社○○○○",
        "NameEn": "XXXX Inc.",
        "WebPage": "http://www.example.jp",
        "EMailAddressList": [
            "info@example.jp",
            "info2@example.jp"
        ],
        "PhoneNumberList": [
            "03-△△△△-××××"
        ],
        "FaxNumber": "03-△△△△-××××",
        "PostalCode": "102-△△△△",
        "Prefecture": "東京都",
        "PostalAddressList": [
            "千代田区富士見△△△△",
            "××××ブルーム"
        ],
        "PostalAddressEnList": [
             "Tokyo",
             "Chiyoda-ku",
             "XXXX Bloom XXXX Fujimi"
        ]
    },
    "Registrant": {
        "Name": "株式会社○○○○",
        "NameEn": "XXXX Inc.",
        "RepresentativeName": "IIJ 太郎",
        "RepresentativeDivision": "情報システム部",
        "EMailAddress": "info@example.jp",
        "PhoneNumber": "03-△△△△-××××",
        "FaxNumber": "03-△△△△-××××",
        "PostalCode": "102-△△△△",
        "Prefecture": "東京都",
        "PostalAddressList": [
            "千代田区富士見△△△△",
            "××××ブルーム"
        ],
        "PostalAddressEnList": [
            "Tokyo",
            "Chiyoda-ku",
            "XXXX Bloom XXXX Fujimi"
        ]
    },
    "DoLinkageType": "EXISTING_DO",
    "DoServiceCode": "do1234567"
}
レスポンスボディ
JSON
{
    "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
    "DgjServiceCode": "dgj12345678",
}