修改签名
说明:因运营商要求签名报备后再发送,目前所有新增的签名均需要报备,为避免因签名/签名材料修改导致拉长运营商报备时效从而影响短信发送,故此接口暂不支持修改报备中/审核成功的签名。
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以内。) (签名报备中不支持修改此参数) |
|
license_base64 | string | 否 | 签名对应的资质图片进行 base64 编码格式转换后的字符串(编码后的参数需添加图片头data:image/jpg;base64, )。此参数和 license_url 您可以任选一种需要的方式进行传输。若两种参数都传,优先取 license_url (支持传多个证明文件,允许该参数出现多次,最多支持7次,单个文件大小限制10M以内。) (签名报备中不支持修改此参数) | 无 |
参数说明:参考“添加签名”
响应
名称 | 类型 | 描述 |
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
}
}