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