添加签名
HTTP 头信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;请求
URL：`https://sms.yunpian.com/v2/sign/add.json`
注意：海外服务器地址 us.yunpian.com
访问方式：POST请求参数
参数名 | 类型 | 是否必须 | 描述 | 示例 |
apikey | string | 是 | 用户唯一标识，在账号设置-子帐号管理中查看 | 9b11127a9701975c734b8aee81ee3526 |
sign | string | 是 | 签名内容 | |
sign_use | integer | 否 | 签名用途， 0:自用 | 1:他用。 自用 （签名为请求的账号实名认证企业名下的网站、产品名等） 他用（签名为非请求账号实名认证企业名下的网站、产品名等） 请按照实际情况严格填写，用途将影响审核结果 | 1 |
website | string | 否 | 业务网址：建议填写签名对应的业务网址和场景 （平台为了规范审核，2021年9月8日起为必传项，请开发者提前完成对接） | |
prove_type | long | 否 | 根据签名内容需要提供的证明文件类型，其中： 1：公司营业执照(签名是公司名称)； 2：工信部icp备案截图，含app名称(签名是APP名称)； 3：工信部icp备案截图，需要对应名称也进行备案(签名是网站名称)； 6：商标注册证书/商标软著权证明(签名是商标名称) | 1 |
license_url | string | 否 | 签名对应的营业执照或其他企业资质的图片文件 URL，URL 由请求方提供。(支持传多个证明文件，允许该参数出现多次，最多支持7次，单个文件大小限制10M以内。相关代码可参考：参数传多次代码示例) | |
license_base64 | string | 否 | 签名对应的资质图片进行 base64 编码格式转换后的字符串（编码后的参数需添加图片头data:image/jpg;base64, ）。 此参数和 license_url 您可以任选一种需要的方式进行传输。若两种参数都传，优先取 license_url。(支持传多个证明文件，允许该参数出现多次，最多支持7次，单个文件大小限制10M以内。) 签名为他用时，此参数与license_url选一个必传！不传签名将会被驳回。 | 无 |
business_license_name | 否 | 签名所属企业营业执照上的企业名称 签名为他用时，此参数必传！不传签名将会被驳回。 | 杭州云片网络科技有限公司 | |
id_card_name | string | 否 | 签名所属企业责任人（法人）身份证姓名。 签名为他用时，此参数必传！不传签名将会被驳回。 | 张三 |
id_card_number | string | 否 | 签名所属企业责任人（法人）身份证号（身份证必须为18位，前17位须为纯数字，最后一位须为数字或大小写X）。 签名为他用时，此参数必传！不传签名将会被驳回。 | 53010219200508011× |
id_card_front_url | string | 否 | 签名对应的企业责任人（法人）身份证图片国徽面URL，URL 由请求方提供。(优先取值，图片仅支持jpg、png、jpeg格式，大小5M内。) | |
id_card_back_url | string | 否 | 签名对应的企业责任人（法人）身份证图片人像面URL，URL 由请求方提供。(优先取值，图片仅支持jpg、png、jpeg格式，大小5M内。) | |
id_card_front | string | 否 | 对应的企业责任人（法人）身份证图片进行 base64 编码格式转换后的字符串（图片仅支持jpg、png、jpeg格式，大小5M以内。)（身份证正面）。 签名为他用时，此参数与id_card_front_url选一个必传！不传签名将会被驳回。 | |
id_card_back | string | 否 | 对应的企业责任人（法人）身份证图片进行 base64 编码格式转换后的字符串（图片仅支持jpg、png、jpeg格式，大小5M以内。)（身份证反面） 签名为他用时，此参数与id_card_front_url选一个必传！不传签名将会被驳回。 | |
agent_mobile | 否 | 签名所属企业责任人/法人/经办人身份证实名手机号。 必须是提供的身份证实名的，如非实名号码签名报备将会失败 签名为他用时，此参数必传！不传签名将会被驳回。 | 13011111111 | |
notify | boolean | 否 | 是否短信通知结果，默认 true | true |
apply_vip | boolean | 否 | 是否申请专用通道，默认 false | false |
is_only_global | boolean | 否 | 是否发国际短信，默认 false | false |
industry_type | string | 否 | 所属行业，默认“其它” | 生产/加工/制造 |
参数说明
- sign
- 不能包含【】
- 不能是“云片网”
- 2-20 个字
- 支持中文、英文、数字和常用符号。
- apply_vip
- 仅发国际短信(is_only_global)的签名不能申请专用通道，此项(apply_vip)会被置为 false
- industry_type
- 可选项(必须完全一致，匹配失败自动转为“其它”):
- 枚举值：1. 游戏 2. 移动应用 3. 视频 4. IT/通信/电子服务 5. 电子商务 6. 金融 7. 网站 8. 商业服务 9. 房地产/建筑 10. 零售/租赁/贸易 11. 生产/加工/制造 12. 交通/物流 13. 文化传媒 14. 能源/电气 15. 政府企业 16. 农业 17. 物联网 18. 其它
响应
名称 | 类型 | 描述 |
code | int | 错误号码，正确为 0 |
msg | string | 示例“ok” |
sign | json 数组 | 返回的签名 json 数组 |
sign 中具体示例：
名称 | 类型 | 描述 |
apply_state | string | 当前审核状态 |
sign | string | 签名 |
is_apply_vip | boolean | 是否为专用通道 |
is_only_global | boolean | 是否申请仅国际短信 |
industry_type | string | 类型 |
Json 响应示例：
调用成功的返回值示例：
{
"code": 0,
"msg": "OK",
"sign": {
"apply_state": "CHECKING",
"sign": "【云片网】",
"is_apply_vip": false,
"is_only_global": true,
"industry_type": "IT/通信/电子服务"
}
}调用失败的返回值示例：
{
"http_status_code": 400,
"code": 2,
"msg": "请求参数格式错误",
"detail": "参数sign格式不正确，sign不能是'云片网'"
}
浙公网安备33010602013820号