短信签名

通过以下接口可以对短信签名进行查询, 添加 修改操作.

查询单个签名

返回短信签名的基本信息

URL 

https://api.sendcloud.net/smsapi/sign/get

HTTP请求方式

post    get

参数说明

参数 类型 必须 说明
smsUser string 是 smsUser
id Integer 是 短信签名id
signature string 是 数字签名, 合法性验证

请求示例

https://api.sendcloud.net/smsapi/sign/get?smsUser=***&id=***&signature=***

返回值说明

参数 说明
id 短信签名id
signName 短信签名名称
signTypeDesc 签名类型描述
verifyStatus 审核状态
createTime 短信签名创建时间
updateTime 短信签名更新时间

返回值示例

{
    "info": {
        "smsSignVo": {
            "createTime": "2015-04-10 10:44:37",
            "id": 0,
            "signName": "闪闪",
            "signTypeDesc": "国内短信",
            "updateTime": "2016-06-14 19:20:35",
            "verifyStatus": "审核通过"
        }
    },
    "statusCode": 200,
    "message": "获取短信签名成功",
    "result": true
}

查询多个签名

返回短信模板的基本信息

URL 

https://api.sendcloud.net/smsapi/sign/list

HTTP请求方式

post    get

参数说明

参数 类型 必须 说明
smsUser string 是 smsUser
signature string 是 数字签名, 合法性验证

请求示例

https://api.sendcloud.net/smsapi/sign/list?smsUser=***&signature=***

返回值说明

参数 说明
id 短信签名id
signName 短信签名名称
signTypeDesc 签名类型描述
verifyStatus 审核状态
createTime 短信签名创建时间
updateTime 短信签名更新时间

返回值示例

{
    "info": {
        "voList": [{
                "createTime": "2015-04-10 10:44:37",
                "id": 1427,
                "signName": "闪达",
                "signTypeDesc": "国内短信",
                "updateTime": "2016-06-14 19:20:35",
                "verifyStatus": "审核通过"
            }, {
                "createTime": "2017-06-27 14:24:31",
                "id": 1429,
                "signName": "闪达1",
                "signTypeDesc": "国内短信",
                "updateTime": "2017-06-27 14:24:31",
                "verifyStatus": "待审核"
            }, {
                "createTime": "2017-06-27 14:24:45",
                "id": 1430,
                "signName": "闪达2",
                "signTypeDesc": "国内短信",
                "updateTime": "2017-06-27 14:24:45",
                "verifyStatus": "待审核"
            }
        ]
    },
    "statusCode": 200,
    "message": "获取短信签名成功",
    "result": true
}

添加签名

返回添加成功后的短信签名基本信息

URL 

https://api.sendcloud.net/smsapi/sign/add

HTTP请求方式

post    get

参数说明

参数 位置 类型 必须 说明
smsUser query string 是 smsUser
signName query string 是 签名名称
signType query string 是 签名类型 0 国内 1 国际
signSource query string 是 签名来源
0企事业单位的全称或简称
2已上线APP应用的全称或简称(国内签名不允许添加)
5商标名的全称或简称
isThirdRights query string 是 是否涉及第三方权益: 0否 1是
thirdName query string 否 法人姓名，当signType参数为0，且isThirdRights参数为1时，必传
thirdCompany query string 否 公司名称，当signType参数为0，且isThirdRights参数为1时，必传
thirdTaxpayerId query string 否 统一社会信用代码，当signType参数为0，且isThirdRights参数为1时，必传
thirdRightsName query string 否 经办人姓名，当signType参数为0，且isThirdRights参数为1时，必传
thirdRightsId query string 否 经办人身份证号码，当signType参数为0，且isThirdRights参数为1时，必传
thirdRightsPhone query string 否 经办人手机号码，当signType参数为0，且isThirdRights参数为1时，必传
signature query string 是 数字签名, 合法性验证
businessLicenseImg body string(binary) 否 当isThirdRights参数为1时 则必传。文件大小上限2MB.不参与数字签名
otherImgs body string(binary) 否 附加图片，签名为已注册的商标全称时，需上传商标证书，最大个数3个。每个文件大小上限2MB.不参与数字签名

说明：

  1. 若传businessLicenseImg或otherImgs 文件时，必须用表单提交（form-data）；若不传文件，则用x-www-form-urlencoded
  2. 仅通过短信备案的账号，可以调用，否则报错 "短信未备案，请登录网站提交短信备案"

Body 请求示例

businessLicenseImg: file://C:\Users\Administrator\Pictures\dog.jpg
otherImgs:
  - file://C:\Users\Administrator\Pictures\linglong1.jpg
  - file://C:\Users\Administrator\Pictures\linglong2.jpg
  - file://C:\Users\Administrator\Pictures\linglong3.jpg

返回值示例

{

    "result": true,
    "statusCode": 200,
    "message": "请求成功",
    "info": {
        "id": 11617     #签名ID
    }
}

更新签名

返回更新成功之后的短信签名的基本信息

URL 

https://api.sendcloud.net/smsapi/sign/update

HTTP请求方式

post    get
参数 位置 类型 必须 说明
smsUser query string 是 smsUser
id query string 是 签名ID
signName query string 否 签名名称
signType query string 否 签名类型 0 国内 1 国际
signSource query string 否 签名来源
0企事业单位的全称或简称
2已上线APP应用的全称或简称(国内签名不允许添加)
5商标名的全称或简称
thirdName query string 否 法人姓名，当signType参数为0，且isThirdRights参数为1时，必传
thirdCompany query string 否 公司名称，当signType参数为0，且isThirdRights参数为1时，必传
thirdTaxpayerId query string 否 统一社会信用代码，当signType参数为0，且isThirdRights参数为1时，必传
thirdRightsName query string 否 经办人姓名，当signType参数为0，且isThirdRights参数为1时，必传
thirdRightsId query string 否 经办人身份证号码，当signType参数为0，且isThirdRights参数为1时，必传
thirdRightsPhone query string 否 经办人手机号码，当signType参数为0，且isThirdRights参数为1时，必传
signature query string 是 数字签名, 合法性验证
businessLicenseImg body string(binary) 否 当isThirdRights参数为1时 则必传。文件大小上限2MB.不参与数字签名
otherImgs body string(binary) 否 附加图片，签名为已注册的商标全称时，需上传商标证书，最大个数3个。每个文件大小上限2MB.不参与数字签名

说明：

  1. 若传businessLicenseImg或otherImgs 文件时，必须用表单提交（form-data）；若不传文件，则用x-www-form-urlencoded
  2. 仅可修改审核不通过的短信签名

请求示例

businessLicenseImg: file://C:\Users\Administrator\Pictures\dog.jpg
otherImgs:
  - file://C:\Users\Administrator\Pictures\linglong1.jpg
  - file://C:\Users\Administrator\Pictures\linglong2.jpg
  - file://C:\Users\Administrator\Pictures\linglong3.jpg

删除签名

返回是否删除成功的基本信息

URL 

https://api.sendcloud.net/smsapi/sign/delete

HTTP请求方式

post    get
参数 位置 类型 必须 说明
smsUser query string 是 smsUser
id query string 是 签名ID
signature query string 是 数字签名, 合法性验证