添加簽名
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`
注意：海外服務(wù)器地址 us.yunpian.com
訪問方式：POST請求參數(shù)
參數(shù)名 | 類型 | 是否必須 | 描述 | 示例 |
apikey | string | 是 | 用戶唯一標(biāo)識，在賬號設(shè)置-子帳號管理中查看 | 9b11127a9701975c734b8aee81ee3526 |
sign | string | 是 | 簽名內(nèi)容 | 云片網(wǎng) |
website | string | 否 | 業(yè)務(wù)網(wǎng)址：建議填寫簽名對應(yīng)的業(yè)務(wù)網(wǎng)址和場景 （平臺為了規(guī)范審核，2021年9月8日起為必傳項(xiàng)，請開發(fā)者提前完成對接） | http://www.ssjdyy2.com，企業(yè)官網(wǎng) |
notify | boolean | 否 | 是否短信通知結(jié)果，默認(rèn) true | true |
apply_vip | boolean | 否 | 是否申請專用通道，默認(rèn) false | false |
is_only_global | boolean | 否 | 是否發(fā)國際短信，默認(rèn) false | false |
industry_type | string | 否 | 所屬行業(yè)，默認(rèn)“其它” | 生產(chǎn)/加工/制造 |
prove_type | long | 否 | 根據(jù)簽名內(nèi)容需要提供的證明文件類型，其中： 1：公司營業(yè)執(zhí)照(簽名是公司名稱)； 2：應(yīng)用商店APP管理后臺全屏截圖(簽名是APP名稱)； 6：商標(biāo)注冊證書/商標(biāo)軟著權(quán)證明(簽名是商標(biāo)名稱) | 1 |
license_url | string | 否 | 簽名對應(yīng)的營業(yè)執(zhí)照或其他企業(yè)資質(zhì)的圖片文件 URL，URL 由請求方提供。(支持傳多個(gè)證明文件，允許該參數(shù)出現(xiàn)多次，最多支持7次，單個(gè)文件大小限制10M以內(nèi)。相關(guān)代碼可參考：參數(shù)傳多次代碼示例) |
|
license_base64 | string | 否 | 簽名對應(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)。) | 無 |
id_card_name | string | 否 | 簽名所屬企業(yè)責(zé)任人（法人）身份證姓名。 簽名為非請求賬號實(shí)名認(rèn)證企業(yè)的名稱/網(wǎng)站/產(chǎn)品名時(shí)，此參數(shù)必傳！不傳簽名將會被駁回。 | 張三 |
id_card_number | string | 否 | 簽名所屬企業(yè)責(zé)任人（法人）身份證號（身份證必須為18位，前17位須為純數(shù)字，最后一位須為數(shù)字或大小寫X）。 簽名為非請求賬號實(shí)名認(rèn)證企業(yè)的名稱/網(wǎng)站/產(chǎn)品名時(shí)，此參數(shù)必傳！不傳簽名將會被駁回。 | 53010219200508011× |
id_card_front | string | 否 | 對應(yīng)的企業(yè)責(zé)任人（法人）身份證圖片進(jìn)行 base64 編碼格式轉(zhuǎn)換后的字符串（圖片僅支持jpg、png、jpeg格式，大小5M以內(nèi)。)（身份證正面）。 簽名為非請求賬號實(shí)名認(rèn)證企業(yè)的名稱/網(wǎng)站/產(chǎn)品名時(shí)，此參數(shù)必傳！不傳簽名將會被駁回。 | |
id_card_back | string | 否 | 對應(yīng)的企業(yè)責(zé)任人（法人）身份證圖片進(jìn)行 base64 編碼格式轉(zhuǎn)換后的字符串（圖片僅支持jpg、png、jpeg格式，大小5M以內(nèi)。)（身份證反面） 簽名為非請求賬號實(shí)名認(rèn)證企業(yè)的名稱/網(wǎng)站/產(chǎn)品名時(shí)，此參數(shù)必傳！不傳簽名將會被駁回。 | |
sign_use | integer | 否 | 簽名用途， 0:自用 | 1:他用。 請按照實(shí)際情況嚴(yán)格填寫，用途將影響審核結(jié)果 | 1 |
id_card_front_url | string | 否 | 簽名對應(yīng)的企業(yè)責(zé)任人（法人）身份證圖片國徽面URL，URL 由請求方提供。(優(yōu)先取值，圖片僅支持jpg、png、jpeg格式，大小5M內(nèi)。) | |
id_card_back_url | string | 否 | 簽名對應(yīng)的企業(yè)責(zé)任人（法人）身份證圖片人像面URL，URL 由請求方提供。(優(yōu)先取值，圖片僅支持jpg、png、jpeg格式，大小5M內(nèi)。) |
參數(shù)說明
- sign
- 不能包含【】
- 不能是“云片網(wǎng)”
- 2-20 個(gè)字
- 支持中文、英文、數(shù)字和常用符號。
- apply_vip
- 僅發(fā)國際短信(is_only_global)的簽名不能申請專用通道，此項(xiàng)(apply_vip)會被置為 false
- industry_type
- 可選項(xiàng)(必須完全一致，匹配失敗自動轉(zhuǎn)為“其它”):
- 枚舉值：1. 游戲 2. 移動應(yīng)用 3. 視頻 4. IT/通信/電子服務(wù) 5. 電子商務(wù) 6. 金融 7. 網(wǎng)站 8. 商業(yè)服務(wù) 9. 房地產(chǎn)/建筑 10. 零售/租賃/貿(mào)易 11. 生產(chǎn)/加工/制造 12. 交通/物流 13. 文化傳媒 14. 能源/電氣 15. 政府企業(yè) 16. 農(nóng)業(yè) 17. 物聯(lián)網(wǎng) 18. 其它
響應(yīng)
名稱 | 類型 | 描述 |
code | int | 錯(cuò)誤號碼，正確為 0 |
msg | string | 示例“ok” |
sign | json 數(shù)組 | 返回的簽名 json 數(shù)組 |
sign 中具體示例：
名稱 | 類型 | 描述 |
apply_state | string | 當(dāng)前審核狀態(tài) |
sign | string | 簽名 |
is_apply_vip | boolean | 是否為專用通道 |
is_only_global | boolean | 是否申請僅國際短信 |
industry_type | string | 類型 |
Json 響應(yīng)示例：
調(diào)用成功的返回值示例：
{
"code": 0,
"msg": "OK",
"sign": {
"apply_state": "CHECKING",
"sign": "【云片網(wǎng)】",
"is_apply_vip": false,
"is_only_global": true,
"industry_type": "IT/通信/電子服務(wù)"
}
}調(diào)用失敗的返回值示例：
{
"http_status_code": 400,
"code": 2,
"msg": "請求參數(shù)格式錯(cuò)誤",
"detail": "參數(shù)sign格式不正確，sign不能是'云片網(wǎng)'"
}
浙公網(wǎng)安備33010602013820號