文档_云片

修改签名

说明：因运营商要求签名报备后再发送，目前所有新增的签名均需要报备，为避免因签名/签名材料修改导致拉长运营商报备时效从而影响短信发送，故此接口暂不支持修改报备中/审核成功的签名。

HTTP 头信息:

Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;

请求

URL：https://sms.yunpian.com/v2/sign/update.json
注意：海外服务器地址 us.yunpian.com
访问方式：POST

请求参数

参数名	类型	是否必须	描述	示例
apikey	string	是	用户唯一标识，在"账号设置"-"子帐号管理"中查看	9b11127a9701975c734b8aee81ee3526
old_sign	string	是	完整签名内容，用于指定修改哪个签名，可以加【】也可不加 (签名报备中不支持修改此参数)	云片网
sign	string	是	修改后签名内容，不带【】，内容无修改则传原签名 (签名报备中不支持修改此参数)	云片网络
website	string	否	业务网址：建议填写签名对应的业务网址和场景（平台为了规范审核，2021年9月8日起为必传项，请开发者提前完成对接） (签名报备中不支持修改此参数)	https://www.yunpian.com，企业官网
notify	boolean	否	是否短信通知结果，无此参数默认 true	true
apply_vip	boolean	否	是否申请专用通道，无此参数默认 false (签名报备中不支持修改此参数)	false
is_only_global	boolean	否	是否仅发国际短信，无此参数默认 false	false
industry_type	string	否	所属行业，无此参数不修改	生产/加工/制造
license_url	string	否	签名对应的营业执照或其他企业资质的图片文件 URL，URL 由请求方提供(支持传多个证明文件，允许该参数出现多次，最多支持7次，单个文件大小限制10M以内。) (签名报备中不支持修改此参数)	`https://example.com/demo.png`
license_base64	string	否	签名对应的资质图片进行 base64 编码格式转换后的字符串（编码后的参数需添加图片头data:image/jpg;base64, ）。此参数和 license_url 您可以任选一种需要的方式进行传输。若两种参数都传，优先取 license_url (支持传多个证明文件，允许该参数出现多次，最多支持7次，单个文件大小限制10M以内。) (签名报备中不支持修改此参数)	无
sign_use	integer	否	签名用途， 0:自用 \| 1:他用。请按照实际情况严格填写	1
id_card_name	string	否	签名所属企业责任人（法人）身份证姓名。签名为非请求账号实名认证企业的名称/网站/产品名时，此参数必传！不传签名将会被驳回。	张三
id_card_number	string	否	签名所属企业责任人（法人）身份证号。签名为非请求账号实名认证企业的名称/网站/产品名时，此参数必传！不传签名将会被驳回。	53010219200508011×
id_card_front	string	否	对应的企业责任人（法人）身份证图片进行 base64 编码格式转换后的字符串（图片仅支持jpg、png、jpeg格式，大小5M以内。)（身份证国徽面）。签名为非请求账号实名认证企业的名称/网站/产品名时，此参数必传！不传签名将会被驳回。
id_card_back	string	否	对应的企业责任人（法人）身份证图片进行 base64 编码格式转换后的字符串（图片仅支持jpg、png、jpeg格式，大小5M以内。)（姓名面）签名为非请求账号实名认证企业的名称/网站/产品名时，此参数必传！不传签名将会被驳回。
id_card_front_url	string	否	签名对应的企业责任人（法人）身份证图片国徽面URL，URL 由请求方提供。(优先取值，图片仅支持jpg、png、jpeg格式，大小5M内。)
id_card_back_url	string	否	签名对应的企业责任人（法人）身份证图片人像面URL，URL 由请求方提供。(优先取值，图片仅支持jpg、png、jpeg格式，大小5M内。)

参数说明:参考“添加签名”

响应

名称	类型	描述
code	integer	正确为 0 表示成功，其他值表示错误，错误时不会有下面的数据
msg	string	请求状态消息
sign	json 数组	签名集合，为空表示没有符合条件的签名

sign 中具体示例：

名称	类型	描述
apply_state	string	当前审核状态
sign	string	签名
is_apply_vip	bool	是否为专用通道
is_only_global	bool	是否申请仅国际短信
industry_type	string	类型

Json 响应示例：

{
  "code": 0,
  "msg": "OK",
  "sign": {
    "apply_state": "CHECKING",
    "sign": "【云片短信】",
    "is_only_global": false,
    "industry_type": "IT/通信/电子服务",
    "is_apply_vip": false
  }
}

修改签名

请求

请求参数

响应

Json 响应示例：

马上体验云片