短信API接口_验证码短信_营销通知三网接口

1、发送短信

接口地址：https://api.jisuapi.com/sms/send

支持格式：JSON,JSONP

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/send?mobile=13556811111,13556811112&content=用户您好。【极速数据】&appkey=yourappkey

请求参数：

参数名称	类型	必填	说明
mobile	string	是	手机号不支持群发。
content	string	是	发送内容模板必须是审核通过的。

返回参数：

参数名称	类型	说明
count	string	发送成功条数
accountid	int	子账号ID

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "count": "1",
        "accountid": "1"
    }
}

2、查询余额

接口地址：https://api.jisuapi.com/sms/balance

支持格式：JSON,JSONP

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/balance?appkey=yourappkey

请求参数：

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
accountid	int	子账号ID
company	string	公司名称
totalnum	int	总次数
usednum	int	已使用次数

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": [
        {
            "accountid": "10000",
            "company": "网尚科技",
            "totalnum": "10",
            "usednum": "0"
        },
        {
            "accountid": "10001",
            "company": "极速数据",
            "totalnum": "10",
            "usednum": "0"
        }
    ]
}

3、获取黑名单

接口地址：https://api.jisuapi.com/sms/blackword

支持格式：JSON,JSONP

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/blackword?appkey=yourappkey

请求参数：

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": [
        "卧室",
        "售罄",
        "公馆",
        "宽厅",
        "停车场",
        "主卧"        
    ]
}

4、添加子账号

接口地址：https://api.jisuapi.com/sms/addaccount

支持格式：JSON,JSONP

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/addaccount?company=极速数据&signature=【极速数据】&statusurl=&replyurl=&replyusername=&replypassword=&totalnum=10&appkey=yourappkey

请求参数：

参数名称	类型	必填	说明
company	string	是	企业全称
signature	string	是	签名格式【XXX】
statusurl	string	否	状态报告回送地址设置后可以接收到短信的发送状态报告
replyurl	string	否	短信回送地址设置后可以收到回复短信
replyusername	string	否	回送用户名可设置回送用户名
replypassword	string	否	回送密码
totalnum	int	是	总次数分配的次数，不能超过剩余次数，不能为0

返回参数：

参数名称	类型	说明
company	string	企业全称
signature	string	签名
statusurl	string	设置的状态报告回送地址
replyurl	string	设置的短信回送地址
replyusername	string	设置的回送用户名
replypassword	string	设置的回送密码
totalnum	int	分配的次数
accountid	int	子账号ID

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "company": "极速数据",
        "signature": "【极速数据】",
        "statusurl": "",
        "replyurl": "",
        "replyusername": "",
        "replypassword": "",
        "totalnum": "10",
        "accountid": "1"
    }
}

5、修改子账号

接口地址：https://api.jisuapi.com/sms/editaccount

支持格式：JSON,JSONP

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/editaccount?accountid=1&company=极速数据&signature=【极速数据】&statusurl=&replyurl=&replyusername=&replypassword=&totalnum=10&appkey=yourappkey

请求参数：

参数名称	类型	必填	说明
accountid	int	是	要修改的子账号ID
company	string	是	企业全称
signature	string	是	签名格式【XXX】
statusurl	string	否	状态报告回送地址设置后可以接收到短信的发送状态报告
replyurl	string	否	短信回送地址设置后可以收到回复短信
replyusername	string	否	回送用户名可设置回送用户名
replypassword	string	否	回送密码
totalnum	int	是	总次数分配的次数，不能小于已使用的次数，不能为0

返回参数：

参数名称	类型	说明
company	string	企业全称
signature	string	签名
statusurl	string	设置的状态报告回送地址
replyurl	string	设置的短信回送地址
replyusername	string	设置的回送用户名
replypassword	string	设置的回送密码
totalnum	int	分配的次数
accountid	int	子账号ID

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "company": "极速数据",
        "signature": "【极速数据】",
        "statusurl": "",
        "replyurl": "",
        "replyusername": "",
        "replypassword": "",
        "totalnum": "10",
        "accountid": "1"
    }
}

6、获取子账号列表

接口地址：https://api.jisuapi.com/sms/accountlist

支持格式：JSON,JSONP

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/accountlist?appkey=yourappkey

请求参数：

参数名称	类型	必填	说明
pagenum	int	否	页码默认为1
pagesize	int	否	每页条数默认为20

返回参数：

参数名称	类型	说明
accountid	int	子账号ID
company	string	企业全称
signature	string	签名
statusurl	string	状态报告回送地址
replyurl	string	短信回送地址
replyusername	string	回送用户名
replypassword	string	回送密码
totalnum	int	总次数
usednum	int	已使用次数
status	int	状态
istemnocheck	int	是否模板免审
failreason	string	审核失败原因
addtime	int	子账号添加时间

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "total": "2",
        "pagenum": "1",
        "pagesize": "20",
        "list": [
            {
                "accountid": "1",
                "company": "极速数据",
                "signature": "【极速数据】",
                "statusurl": "",
                "replyurl": "",
                "replyusername": "",
                "replypassword": "",
                "totalnum": "10",
                "usednum": "0",
                "status": "1",
                "istemnocheck": "0",
                "failreason": "",
                "addtime": "1511111111"
            },
            {
                "accountid": "2",
                "company": "极速数据平台",
                "signature": "【极速数据平台】",
                "statusurl": "",
                "replyurl": "",
                "replyusername": "",
                "replypassword": "",
                "totalnum": "10",
                "usednum": "0",
                "status": "1",
                "istemnocheck": "0",
                "failreason": "",
                "addtime": "1511111111"
            }
        ]
    }
}

7、添加模板

接口地址：https://api.jisuapi.com/sms/addtemplate

支持格式：JSON,JSONP

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/addtemplate?accountid=1&name=用户您好&content=用户您好。【极速数据】&ismarket=0&appkey=yourappkey

请求参数：

参数名称	类型	必填	说明
accountid	int	是	子账号ID
name	string	是	模板标识
content	string	是	模板内容营销短信加：回TD退订。替换的内容用@代替，70个字符为一条短信。
ismarket	int	是	是否为营销短信 1为是，0为不是

返回参数：

参数名称	类型	说明
accountid	string	子账号ID
name	string	模板标识
content	string	模板内容
templateid	string	模板ID
status	string	状态
ismarket	string	是否为营销短信

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "accountid": "1",
        "name": "用户您好",
        "content": "用户您好。【极速数据】",
        "templateid": "1",
        "status": "1",
        "ismarket": "0"
    }
}

8、修改模板

接口地址：https://api.jisuapi.com/sms/edittemplate

支持格式：JSON,JSONP

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/edittemplate?accountid=1&templateid=1&name=用户您好&content=用户您好。【极速数据】&ismarket=0&appkey=yourappkey

请求参数：

参数名称	类型	必填	说明
accountid	int	否	子账号ID
templateid	int	是	模板ID
name	string	是	模板标识
content	string	是	模板内容
ismarket	int	是	是否为营销短信 1为是，0为不是

返回参数：

参数名称	类型	说明
accountid	int	子账号ID
name	string	模板标识
content	string	模板内容
templateid	int	模板ID
status	int	状态
ismarket	int	是否为营销短信 1为是，0为不是

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "accountid": "1",
        "name": "用户您好",
        "content": "用户您好。【极速数据】",
        "templateid": "1",
        "status": "1",
        "ismarket": "0"
    }
}

9、获取模板列表

接口地址：https://api.jisuapi.com/sms/templatelist

支持格式：JSON,JSONP

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/templatelist?accountid=1&appkey=yourappkey

请求参数：

参数名称	类型	必填	说明
accountid	int	是	子账号ID
pagenum	int	否	页码默认为1
pagesize	int	否	每页条数默认为20

返回参数：

参数名称	类型	说明
templateid	int	模板ID
name	string	模板标识
content	string	模板内容
ismarket	int	是否为营销短信
status	int	状态
failreason	string	审核失败原因
addtime	int	添加时间

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "total": "1",
        "pagenum": "1",
        "pagesize": "20",
        "accountid": "1",
        "totalnum": "10",
        "usednum": "0",
        "list": [
            {
                "templateid": "1",
                "name": "用户您好",
                "content": "用户您好。【极速数据】",
                "ismarket": "0",
                "status": "1",
                "failreason": "",
                "addtime": "1511111111"
            }
        ]
    }
}

10、获取模板详情

接口地址：https://api.jisuapi.com/sms/templatedetail

支持格式：JSON

请求方式：GET POST

请求示例：https://api.jisuapi.com/sms/templatedetail?templateid=1&appkey=yourappkey

请求参数：

参数名称	类型	必填	说明
templateid	int	是	模板ID

返回参数：

参数名称	类型	说明
templateid	int	模板ID
name	string	模板标识
content	string	模板内容
ismarket	int	是否为营销短信 1为是，0为不是
status	int	模板状态
failreason	string	审核失败原因
addtime	int	添加时间

JSON返回实例：

                        {
    "status": 0,
    "msg": "ok",
    "result": {
        "templateid": "1",
		"name": "用户您好",
		"content": "用户您好。【极速数据】",
		"ismarket": "0",
		"status": "1",
		"failreason": "",
		"addtime": "1511111111"
    }
}

代号	说明
201	手机号为空
202	手机号有误
203	短信内容为空
204	短信内容包含敏感字符
205	签名不存在
206	账户在审核中
207	短信模板不存在
208	短信模板在审核中
209	子账号余额不足
210	指定时间内发送数量超限
211	签名为空
212	签名格式错误
213	签名已存在
214	公司名称为空
215	总次数为空
216	总次数超过剩余次数
217	短信模板名称为空
218	短信子账户为空
219	短信子账户不存在
220	未知错误
221	短信同名模板已存在
222	短信模板内容为空
223	签名和子账户签名不一致
224	您没有发送免审短信权限
225	短信模板审核未通过
226	短信子账户审核未通过
227	短信内容过短
228	总次数不能小于已使用次数
229	账号未实名认证
230	短信变量不合法
231	短信模板ID为空

代号	说明
101	APPKEY为空或不存在
102	APPKEY已过期
103	APPKEY无请求此数据权限
104	请求超过次数限制
105	IP被禁止
106	IP请求超过限制
107	接口维护中
108	接口已停用

名称	权限	价格
免费套餐	10次	免费
Level2	10000次	480.00元
Level4	50000次	2200.00元
Level5	100000次	4200.00元
Level6	200000次	8000.00元

短信

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

请求参数：

返回参数：

JSON返回实例：

API错误码

系统错误码