修改簽名
說(shuō)明:因運(yùn)營(yíng)商要求簽名報(bào)備后再發(fā)送,目前所有新增的簽名均需要報(bào)備,為避免因簽名/簽名材料修改導(dǎo)致拉長(zhǎng)運(yùn)營(yíng)商報(bào)備時(shí)效從而影響短信發(fā)送,故此接口暫不支持修改報(bào)備中/審核成功的簽名。
HTTP 頭信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
請(qǐng)求
URL:https://sms.yunpian.com/v2/sign/update.json
注意:海外服務(wù)器地址 us.yunpian.com
訪問(wèn)方式:POST
請(qǐng)求參數(shù)
參數(shù)名 | 類型 | 是否必須 | 描述 | 示例 |
apikey | string | 是 | 用戶唯一標(biāo)識(shí),在"賬號(hào)設(shè)置"-"子帳號(hào)管理"中查看 | 9b11127a9701975c734b8aee81ee3526 |
old_sign | string | 是 | 完整簽名內(nèi)容,用于指定修改哪個(gè)簽名,可以加【】也可不加 (簽名報(bào)備中不支持修改此參數(shù)) | 云片網(wǎng) |
sign | string | 是 | 修改后簽名內(nèi)容,不帶【】,內(nèi)容無(wú)修改則傳原簽名 (簽名報(bào)備中不支持修改此參數(shù)) | 云片網(wǎng)絡(luò) |
website | string | 否 | 業(yè)務(wù)網(wǎng)址:建議填寫簽名對(duì)應(yīng)的業(yè)務(wù)網(wǎng)址和場(chǎng)景 (平臺(tái)為了規(guī)范審核,2021年9月8日起為必傳項(xiàng),請(qǐng)開發(fā)者提前完成對(duì)接) (簽名報(bào)備中不支持修改此參數(shù)) | http://www.ssjdyy2.com,企業(yè)官網(wǎng) |
notify | boolean | 否 | 是否短信通知結(jié)果,無(wú)此參數(shù)默認(rèn) true | true |
apply_vip | boolean | 否 | 是否申請(qǐng)專用通道,無(wú)此參數(shù)默認(rèn) false (簽名報(bào)備中不支持修改此參數(shù)) | false |
is_only_global | boolean | 否 | 是否僅發(fā)國(guó)際短信,無(wú)此參數(shù)默認(rèn) false | false |
industry_type | string | 否 | 所屬行業(yè),無(wú)此參數(shù)不修改 | 生產(chǎn)/加工/制造 |
license_url | string | 否 | 簽名對(duì)應(yīng)的營(yíng)業(yè)執(zhí)照或其他企業(yè)資質(zhì)的圖片文件 URL,URL 由請(qǐng)求方提供(支持傳多個(gè)證明文件,允許該參數(shù)出現(xiàn)多次,最多支持7次,單個(gè)文件大小限制10M以內(nèi)。) (簽名報(bào)備中不支持修改此參數(shù)) |
|
license_base64 | string | 否 | 簽名對(duì)應(yīng)的資質(zhì)圖片進(jìn)行 base64 編碼格式轉(zhuǎn)換后的字符串(編碼后的參數(shù)需添加圖片頭data:image/jpg;base64, )。此參數(shù)和 license_url 您可以任選一種需要的方式進(jìn)行傳輸。若兩種參數(shù)都傳,優(yōu)先取 license_url (支持傳多個(gè)證明文件,允許該參數(shù)出現(xiàn)多次,最多支持7次,單個(gè)文件大小限制10M以內(nèi)。) (簽名報(bào)備中不支持修改此參數(shù)) | 無(wú) |
sign_use | integer | 否 | 簽名用途, 0:自用 | 1:他用。請(qǐng)按照實(shí)際情況嚴(yán)格填寫 | 1 |
id_card_name | string | 否 | 簽名所屬企業(yè)責(zé)任人(法人)身份證姓名(身份證必須為18位,前17位須為純數(shù)字,最后一位須為數(shù)字或大小寫X))。 簽名為非請(qǐng)求賬號(hào)實(shí)名認(rèn)證企業(yè)的名稱/網(wǎng)站/產(chǎn)品名時(shí),此參數(shù)必傳!不傳簽名將會(huì)被駁回。 | 張三 |
id_card_number | string | 否 | 簽名所屬企業(yè)責(zé)任人(法人)身份證號(hào)。 簽名為非請(qǐng)求賬號(hào)實(shí)名認(rèn)證企業(yè)的名稱/網(wǎng)站/產(chǎn)品名時(shí),此參數(shù)必傳!不傳簽名將會(huì)被駁回。 | 53010219200508011× |
id_card_front | string | 否 | 對(duì)應(yīng)的企業(yè)責(zé)任人(法人)身份證圖片進(jìn)行 base64 編碼格式轉(zhuǎn)換后的字符串(圖片僅支持jpg、png、jpeg格式,大小5M以內(nèi)。)(身份證國(guó)徽面)。 簽名為非請(qǐng)求賬號(hào)實(shí)名認(rèn)證企業(yè)的名稱/網(wǎng)站/產(chǎn)品名時(shí),此參數(shù)必傳!不傳簽名將會(huì)被駁回。 | |
id_card_back | string | 否 | 對(duì)應(yīng)的企業(yè)責(zé)任人(法人)身份證圖片進(jìn)行 base64 編碼格式轉(zhuǎn)換后的字符串(圖片僅支持jpg、png、jpeg格式,大小5M以內(nèi)。)(姓名面) 簽名為非請(qǐng)求賬號(hào)實(shí)名認(rèn)證企業(yè)的名稱/網(wǎng)站/產(chǎn)品名時(shí),此參數(shù)必傳!不傳簽名將會(huì)被駁回。 | |
id_card_front_url | string | 否 | 簽名對(duì)應(yīng)的企業(yè)責(zé)任人(法人)身份證圖片國(guó)徽面URL,URL 由請(qǐng)求方提供。(優(yōu)先取值,圖片僅支持jpg、png、jpeg格式,大小5M內(nèi)。) | |
id_card_back_url | string | 否 | 簽名對(duì)應(yīng)的企業(yè)責(zé)任人(法人)身份證圖片人像面URL,URL 由請(qǐng)求方提供。(優(yōu)先取值,圖片僅支持jpg、png、jpeg格式,大小5M內(nèi)。) |
參數(shù)說(shuō)明:參考“添加簽名”
響應(yīng)
名稱 | 類型 | 描述 |
code | integer | 正確為 0 表示成功,其他值表示錯(cuò)誤,錯(cuò)誤時(shí)不會(huì)有下面的數(shù)據(jù) |
msg | string | 請(qǐng)求狀態(tài)消息 |
sign | json 數(shù)組 | 簽名集合,為空表示沒(méi)有符合條件的簽名 |
sign 中具體示例:
名稱 | 類型 | 描述 |
apply_state | string | 當(dāng)前審核狀態(tài) |
sign | string | 簽名 |
is_apply_vip | bool | 是否為專用通道 |
is_only_global | bool | 是否申請(qǐng)僅國(guó)際短信 |
industry_type | string | 類型 |
Json 響應(yīng)示例:
{
"code": 0,
"msg": "OK",
"sign": {
"apply_state": "CHECKING",
"sign": "【云片短信】",
"is_only_global": false,
"industry_type": "IT/通信/電子服務(wù)",
"is_apply_vip": false
}
}