备案活动域名注册 - 域名APIv2-对外接口

简要描述：

代理 API 注册 2026 备案首年 0 元活动域名（.cn / .中国）

活动价 0 元，固定注册 1 年

须使用当前代理下已审核通过的信息模板，且账号存在未使用的活动优惠券

活动时间 2026-05-01 ~ 2026-12-31；同一主体证件号在 cn 与 .中国后缀分组各限参与 1 次

成功时 data 为 null；DNS 由系统默认分配，Body 中 dns1~dns8 不生效

请求URL：

https://apiv2.xinnet.com/api/domain/beianActivity/createDomainQW

请求方式：

POST

公共请求参数：

请参见调用说明

参数：

参数名	是否必选	类型	说明	示例
domainName	是	string	待注册域名，仅支持 .cn、.中国	example.cn
templateName	是	string	当前代理下信息模板名称（非 userCode），须已审核通过	YYZZ_260130_TySAm
year	是	int	购买年限，必须为 1	1
registrar	否	string	建议传 xinnetQW	xinnetQW
dns1	否	string	本接口不使用	—
dns2	否	string	本接口不使用	—
price	否	string	活动价固定 0，可不传	—
marketingType	否	string	可不传	—

请求示例

{
    "domainName":"example.cn",
    "templateName":"YYZZ_260130_TySAm",
    "year":1,
    "registrar":"xinnetQW"
}

公共响应返回

请参见调用说明

返回信息列表

返回code说明

v2 code	说明
350002	字符编码为空
350002	加密串为空
350002	认证失败
350002	代理号为空
350005	系统错误
350500	参数不能为空（domainName、templateName 等）
355050	参数格式错误（domainName 格式/后缀、year 非 1、域名已存在、模板不存在等）
350024	活动商品不存在
350027	预付款处理失败，请稍后重试
350028	预付款余额不足
351003	域名存在备案
351004	域名已经列入备案黑名单
1	请求失败，具体原因见 msg（见下表）

code=1 时常见 msg（与实现对齐，以实际返回为准）

msg	说明
当前不在活动期内	不在活动时间范围
模板状态未审核通过	模板未审核
模板资料为空	模板资料异常
域名不可注册	Check 不可用等
溢价域名不可参与本活动	溢价词
非常抱歉，您的注册主体已在本次活动期内成功注册…	cn 后缀主体限购（.中国为对应中国后缀文案）
您当前无可用优惠券，买Web应用托管主机 / 应用类产品即可参与本次活动，备案通过后，还可免费续费 1 年。	未领券或无可用券
操作过快，请稍后再试	生产短锁
注册失败	底层注册失败（或其它 payMsg）

备注

成功结果示例

{
    "code":"0",
    "msg":"请求成功",
    "requestId":"mL7Uv3j2gMw0mBF8bj5",
    "data":null
}

错误结果示例

{
    "code":"1",
    "msg":"您当前无可用优惠券，买Web应用托管主机 / 应用类产品即可参与本次活动，备案通过后，还可免费续费 1 年。",
    "requestId":"mL7Uv3j2gMw0mBF8bj5",
    "data":null
}