获取签名


HTTP 头信息:


Accept:application/json;charset=utf-8;
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
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 响应示例:


{
  "code": 0,
  "total": 3,
  "sign": [
    {
      "chan": "NORMAL",
      "check_status": "APLLYING_VIP",
      "enabled": true,
      "extend": "9527",
      "industry_type": "商业服务",
      "only_global": false,
      "remark": "",
      "sign": "【云片网络】",
      "vip": false
    },
    {
      "chan": "GLOBAL",
      "check_status": "SUCCESS",
      "enabled": true,
      "extend": "7788",
      "industry_type": "其它",
      "only_global": true,
      "remark": "",
      "sign": "【云片国际】",
      "vip": false
    },
    {
      "chan": "NONE",
      "check_status": "FAIL",
      "enabled": false,
      "extend": "",
      "industry_type": "其它",
      "only_global": false,
      "remark": "此签名具有特殊性,请联系在线客服提供签名与本公司相关的证明。",
      "sign": "【云片摸摸哒】",
      "vip": false
    }
  ]
}