• 获取签名
    • 请求
    • 请求参数
    • 响应
    • Json响应示例:

    获取签名

    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/get.json

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

    访问方式:POST

    请求参数

    参数名类型是否必须描述示例
    apikeystring用户唯一标识9b11127a9701975c734b8aee81ee3526
    idlong签名id,暂未开放(API文档里先不写),如果传入此参数将会指定获取某个签名1
    signstring返回所有包含该内容的签名(模糊匹配),若要获取指定签名可加上符号,如【云片网】云片
    page_numinteger页码,1开始,不带或者格式错误返回全部1
    page_sizeinteger返回条数,必须大于0,不带或者格式错误返回全部20

    响应

    名称类型描述
    codeinteger正确为0表示成功,其他值表示错误,错误时不会有下面的数据
    totalinteger该查询条件下共有多少记录
    signjson数组签名集合,为空表示没有符合条件的签名

    sign中具体示例:

    名称类型描述
    chanstring通道类型,'NONE'暂未分配,'GLOBAL'国际短信通道,'MARKET'营销通道,'VIP'专用通道,'NORMAL'普通通道
    check_statusstring当前状态,'CHECKING'审核中,'FAIL'审核失败,'SUCCESS'审核成功,'APLLYING_VIP'普通通道审核成功申请升级专用通道中
    enabledboolean当前签名是否启用
    extendstring扩展号,为空表示暂未分配
    industry_typestring行业
    only_globalboolean是否用于国际短信
    remarkstring客服给的审核结果解释,一般见于审核失败
    signstring签名
    vipboolean是否专用通道

    Json响应示例:

    1. {
    2. "code": 0,
    3. "total": 3,
    4. "sign": [
    5. {
    6. "chan": "NORMAL",
    7. "check_status": "APLLYING_VIP",
    8. "enabled": true,
    9. "extend": "9527",
    10. "industry_type": "商业服务",
    11. "only_global": false,
    12. "remark": "",
    13. "sign": "【云片网络】",
    14. "vip": false
    15. },
    16. {
    17. "chan": "GLOBAL",
    18. "check_status": "SUCCESS",
    19. "enabled": true,
    20. "extend": "7788",
    21. "industry_type": "其它",
    22. "only_global": true,
    23. "remark": "",
    24. "sign": "【云片国际】",
    25. "vip": false
    26. },
    27. {
    28. "chan": "NONE",
    29. "check_status": "FAIL",
    30. "enabled": false,
    31. "extend": "",
    32. "industry_type": "其它",
    33. "only_global": false,
    34. "remark": "此签名具有特殊性,请联系在线客服提供签名与本公司相关的证明。",
    35. "sign": "【云片摸摸哒】",
    36. "vip": false
    37. }
    38. ]
    39. }