You need to enable JavaScript to run this app.
导航
域名服务
  • 文档首页
    • /域名服务/API 参考/创建信息模板
创建信息模板
最近更新时间：2025.04.14 13:29:11首次发布时间：2023.05.22 22:30:38
我的收藏
有用
有用
无用
无用

API 说明

API 名称：CreateTemplate
API 域名：open.volcengineapi.com
API 描述：创建一个信息模板用以域名注册。

请求方法

POST

使用限制

节流限制：您每秒最多可以提交 20 个请求。

请求鉴权

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见请求鉴权。

公共参数

在调用该 API 时，您在请求中必须包含公共参数。在这些公共参数中，以下两个查询参数的取值说明如下：

参数名称数据类型必选参数说明
Actionstring是表示 API 的名称。该参数的取值是 CreateTemplate。
Versionstring是表示 API 的版本。该参数的取值是 2022-12-12。

请求参数

该 API 的请求参数的类型是请求正文参数。

参数名称数据类型必选参数说明示例

registration_type

string

是

表示域名所有者的类型。该参数有以下取值：

  • C：表示企业。

  • P：表示个人。

C

registrant_zh

string

是

该参数的含义如下：

  • 如果 registration_type 是 P，该参数表示域名所有者的中文姓名。

  • 如果 registration_type 是 C，该参数表示企业的中文名称。

该参数必须中文汉字，可以包含字母和数字，长度在 2 到 64 个字符之间。 参数值必须与 id_img 所表示的证件正面照片上的姓名或企业名称相同。

李萌

registrant

string

是

该参数的含义如下：

  • 如果 registration_type 是 P，该参数表示域名所有者的英文姓名，可以是中文姓名的拼音。

  • 如果 registration_type 是 C，该参数表示企业的英文名称，可以是企业中文名称的拼音。

该参数可以包含字母和数字，长度不能超过 64 个字符。

Li Meng

registrant_ln_zh

string

是

表示联系人中文姓名中的姓，必须包含汉字，可以包含字母和数字。

张

registrant_fn_zhstring是表示联系人中文姓名中的名，必须包含汉字，可以包含字母和数字。三
registrant_fnstring是表示联系人英文姓名中的名，可以是中文姓名中名的拼音。该参数必须包含字母，可以包含数字。san
registrant_lnstring是表示联系人英文姓名中的姓，可以是中文姓名中姓的拼音。该参数必须包含字母，可以包含数字。zhang

address_zh

string

是

表示联系人的中文地址。中文地址必须包含中文，可以包含字母和数字，长度在 2 到 128 个字符之间。建议您输入的地址与您上传的证件图片中的地址相同。

注意

地址必须包含完整的中国省级行政区名称和城市名称。例如，辽宁省沈阳市是符合要求的，辽宁沈阳 不符合要求。如果地址不符合要求，信息模板将无法通过审核。

黑龙江省大庆市萨尔图区拥军大街3-10号5门2室

address

string

是

表示联系人的英文地址。英文地址必须包含字母，可以包含数字，长度不能超过 128 个字符。

Hei Long Jiang Sheng Da Qing Shi Sa Er Tu Qu Yong Jun Da Jie 3-10 Hao 5 Men 2 Shi

state_zhstring是表示 address_zh 所包含的中国省级行政区的中文名称。该参数的长度不能超过 64 个字符，必须包含中文汉字，可以包含字母和数字。黑龙江省
statestring是表示 state_zh 的拼音。该参数的长度不能超过 64 个字符，必须包含字母，可以包含数字。heilongjiangsheng

city_zh

string

是

表示 address 所包含城市的中文名称。该参数的长度不能超过 64 个字符，必须包含中文汉字，可以包含字母和数字。

北京市

citystring是表示 city_zh 的拼音。该参数的长度不能超过 64 个字符，必须包含字母，可以包含数字。beijingshi

tel_number

string

是

表示联系人的电话号码。电话号码只能包含数字，长度不超过 11 个字符。

  • 如果 tel_area_code 为空，tel_number 表示联系人的手机号码。
  • 如果 tel_area_code 不为空，tel_number 表示联系人的固定电话号码。

12345678912

tel_extensionstring否表示联系人电话号码的分机号，长度为 1-4 个字符。如果 tel_number 是手机号码，您无需指定该参数。1234

tel_area_code

string

否

表示联系人电话号码所对应的区号。该参数只能包含数字，长度为 3-4 个字符。

  • 如果 tel_number 是手机号码，您无需指定该参数。

  • 如果 tel_number 是固定电话号码，您必须指定该参数。

注意

区号必须匹配 city_zh。

tel_country_codestring是表示 tel_number 所对应国家的国家码。当前，国家码只能是 86。86 是中国的国家码。86
post_codestring是表示 address_zh 的邮编。该参数只能包含数字，长度是 6 个字符。163000
emailstring是表示联系人的邮箱地址。aaa@example.com

id_type

string

否

表示域名所有者提供的证件的类型。证件类型是在"个人"与"企业"这 2 个大类下。该参数有以下取值：

个人

  • SFZ：表示身份证。

  • HZ：表示护照。

  • TXZ：表示港澳居民来往内地通行证。

  • TWSFZ：台湾居民来往大陆通行证。

  • GWSFZ：表示外国人永久居留身份证。

  • GAJZZ：表示港澳居民居住证。

  • TWJZZ：表示台湾居民居住证。

企业

  • ORG：表示组织机构代码证。

  • YYZZ：表示工商营业执照。

  • TYDMZ：表示统一社会信用代码证书。

  • BDDH：表示部队代号。

  • JDXKZ：表示军队单位对外有偿服务许可证。

  • SYZS：表示事业单位法人证书。

  • GWCZDJZ：表示外国企业常驻代表机构登记。

  • STDJZ：表示社会团体法人登记证书。

  • ZJDJZ：表示宗教活动场所登记证。

  • MBDJZ：表示民办非企业单位登记证书。

  • JJDJZ：表示基金会法人登记证书。

  • LSXKZ：表示律师事务所执业许可证。

  • GWZHDJZ：表示外国在华文化中心登记证。

  • GWLYDJZ：表示外国政府旅游部门常驻代表机构批准登记证。

  • SFXKZ：表示司法鉴定许可证。

  • GWJGZJ：表示外国机构证件。

  • SHFWJGZ：表示社会服务机构登记证书。

  • MBXXXKZ：表示民办学校办学许可证。

  • YLJGXKZ：表示医疗机构执业许可证。

  • GZJGZYZ：表示公证机构执业证。

  • BJWSXX：表示北京市外国驻华使馆人员子女学校办学许可证。

  • QTTYDMZ：表示其他统一社会信用代码证书。

如果您需要在模板创建后对模板启动实名认证流程，该参数必填。

SFZ

id_code

string

是

表示证件号码。例如身份证号码、营业执照号码等。

如果您需要在模板创建后对模板启动实名认证流程，该参数必填。

310115198404191234

id_img

string

否

表示证件正面照片，以 Base64 编码的字符串。照片格式可以是 JPG/JPEG、PNG、BMP 或者 GIF，文件大小在 55KB 到 5MB 之间。

如果您需要在模板创建后对模板启动实名认证流程，该参数必填。

响应正文

参数名称数据类型参数说明示例
tagstring表示创建的信息模板的 tag。G0zM6RUUWLPysIuVPF7obA==

示例

请求示例

POST https://open.volcengineapi.com?Version=2022-12-12&Action=CreateTemplate
{
    "registration_type":"P",
    "post_code":"163000",
    "email": "aaa@example.com",
    "registrant":"San Zhang",
    "registrant_fn":"San",
    "registrant_ln":"Zhang",
    "address":"My Address",
    "city":"Shanghai",
    "state":"Shanghai",
    "registrant_zh": "张三",
    "registrant_fn_zh":"三",
    "registrant_ln_zh":"李",
    "address_zh":"我的地址",
    "city_zh": "上海",
    "state_zh": "上海",
    "tel_country_code": "86",
    "tel_number":"12345678963"
}

响应示例

{
    "ResponseMetadata": {
        "RequestId": "20230522152902BF8AE46450333517309F",
        "Action": "CreateTemplate",
        "Version": "2022-12-12",
        "Service": "domain_openapi",
        "Region": "cn-north-1"
    },
    "Result": {
        "tag": "G0zM6RUUWLPysIuVPF7obA=="
    }
}

错误码

如果响应正文包含 Error 字段，则表示 API 请求失败。下表列出了该 API 可能返回的错误码。

错误码错误信息
81713请求body过大，不能超过7M，检查下实名证件图片的base64内容是否过大
81400无效的参数，如参数值类型和api文档要求类型不相符
81801注册联系人字段中包含无效字符或者过长
81802注册人地址包含无效字符或者过长
81803注册联系人失败
81804注册所有人字段中包含无效字符或者过长
81805邮箱格式检查异常
81840邮编格式检查异常
81841证件类型不在枚举类型中
81842持有者类型不在枚举类型中
81843持有者类型和证件类型不匹配
81839注册所有人(中英文)和注册联系人(中英文)值里面有无效字符
81712注册所有人(中文)和注册联系人姓名(中文)必须含有中文字符
81711注册所有人(英文)和注册联系人姓名(英文)不能含有中文字符
81838固话/手机号信息准确填写不正确, 如号码有无效字符、长度不符合要求
81796证件号码格式错误
81792注册所有人证件扫描件格式不符或大小超限，只能上传55K-1M的证件
81795新增的模板和已创建的模板重复，建议修改/删减部分通讯地址文字重试
81722注册所有人在黑名单
81791证件号码和证件类型不匹配
81500网络异常，可以重试

如果该 API 返回的错误码不在该列表中，请参见 公共错误码。