国内短信 - 获取签名 - 《云片短信API文档》

获取签名

获取签名

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

请求参数

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

响应

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

sign中具体示例：

名称	类型	描述
chan	string	通道类型，'NONE'暂未分配，'GLOBAL'国际短信通道，'MARKET'营销通道，'VIP'专用通道，'NORMAL'普通通道
check_status	string	当前状态,'CHECKING'审核中，'FAIL'审核失败，'SUCCESS'审核成功，'APLLYING_VIP'普通通道审核成功申请升级专用通道中
enabled	boolean	当前签名是否启用
extend	string	扩展号，为空表示暂未分配
industry_type	string	行业
only_global	boolean	是否用于国际短信
remark	string	客服给的审核结果解释，一般见于审核失败
sign	string	签名
vip	boolean	是否专用通道

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
        }
    ]
}