• 添加签名
    • 请求
    • 请求参数
    • 响应
    • Json响应示例：（分为指定id和未指定id）

    添加签名

    HTTP头信息: 

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

    请求

    URL：https://sms.yunpian.com/v2/sign/add.json

    注意：海外服务器地址 us.yunpian.com

    访问方式：POST

    请求参数

    参数名类型是否必须描述示例
    apikeystring是用户唯一标识9b11127a9701975c734b8aee81ee3526
    signstring是签名内容云片网
    notifyboolean否是否短信通知结果，默认truetrue
    apply_vipboolean否是否申请专用通道，默认falsefalse
    is_only_globalboolean否是否仅发国际短信，默认falsefalse
    industry_typeString否所属行业，默认“其它”生产/加工/制造
    license_urlstringNo签名对应的营业执照或其他企业资质的图片文件URL，URL由请求方提供https://example.com/demo.png

    参数说明:

    • sign

      • 不能包含【】

      • 不能是“云片网”

      • 3-8个字(开通“不限签名格式”和“仅发国际短信”的用户不受此限)

      • 不能是纯英文和数字(开通“不限签名格式”和“仅发国际短信”的用户不受此限)

    • apply_vip

      • 仅发国际短信(is_only_global)的签名不能申请专用通道，此项(apply_vip)会被置为 false

    • industry_type

      • 可选项(必须完全一致，匹配失败自动转为“其它”):

      • 1.游戏 2. 移动应用 3. 视频 4. IT/通信/电子服务 5. 电子商务 6. 金融 7. 网站 8. 商业服务 9. 房地产/建筑 10. 零售/租赁/贸易 11. 生产/加工/制造 12. 交通/物流 13. 文化传媒 14. 能源/电气 15. 政府企业 16. 农业 17. 物联网 18. 其它

    响应

    名称类型描述
    codeint错误号码，正确为0
    msgstring示例“ok”
    signjson数组返回的签名json数组

    sign中具体示例：

    名称类型描述
    apply_statestring当前审核状态
    signstring签名
    is_apply_vipboolean是否为专用通道
    is_only_globalboolean是否申请仅国际短信
    industry_typestring类型

    Json响应示例：（分为指定id和未指定id）

    调用成功的返回值示例：

    1. {
    2.     "code": 0,
    3.     "msg": "OK",
    4.     "sign": {
    5.         "apply_state": "CHECKING",
    6.         "sign": "【云片网】",
    7.         "is_apply_vip": false,
    8.         "is_only_global": true,
    9.         "industry_type": "IT/通信/电子服务"
    10.     }
    11. }

    调用失败的返回值示例：

    1. {
    2.     "http_status_code": 400,
    3.     "code": 2,
    4.     "msg": "请求参数格式错误",
    5.     "detail": "参数sign格式不正确，sign不能是'云片网'"
    6. }