短信签名

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

查询单个签名

返回短信签名的基本信息

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企事业单位的全称或简称 1工信部备案网站的全称或简称 2已上线APP应用的全称或简称 3公众号或小程序的全称或简称 4电商平台店铺名的全称或简称 5商标名的全称或简称
isThirdRights	query	string	是	是否涉及第三方权益: 0否 1是
signature	query	string	是	数字签名, 合法性验证
businessLicenseImg	body	string(binary)	否	当isThirdRights参数为1时则必传。文件大小上限2MB.不参与数字签名
otherImgs	body	string(binary)	否	附加图片，最大个数3个。每个文件大小上限2MB.不参与数字签名

说明：

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

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企事业单位的全称或简称 1工信部备案网站的全称或简称 2已上线APP应用的全称或简称 3公众号或小程序的全称或简称 4电商平台店铺名的全称或简称 5商标名的全称或简称
isThirdRights	query	string	否	是否涉及第三方权益: 0否 1是
signature	query	string	是	数字签名, 合法性验证
businessLicenseImg	body	string(binary)	否	当isThirdRights参数为1时则必传。文件大小上限2MB。不参与数字签名
otherImgs	body	string(binary)	否	附加图片，最大个数3个。每个文件大小上限2MB。不参与数字签名

说明：

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

请求示例

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	是	数字签名, 合法性验证