短信SMS接口文档 1. 用户相关 2. 短信模板 2.1 添加 2.2 修改 2.3 列表 请求 请求参数 响应 Json响应示例 2.4 删除 请求 请求参数 响应 Json响应示例 3. 短信签名 3.1 添加 3.2 修改 3.3 列表 3.4 删除 4. 短信发送 5. 短信状态 6. 上行
1. 用户相关
1.1 获取用户余额
请求
URL:https://api.xingkongqixin.com/api/v1/sms/user/balance.json 请求方式:GET
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb
注意事项:
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok data Long 账号余额 40
Json响应示例
{"data": 400,"code": 0,"msg": "ok"
}
2. 短信模板
2.1 添加
请求
URL:https://api.xingkongqixin.com/api/v1/sms/tpl/add.json 请求方式:POST
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb type true
String 模板类型 1:验证码, 2:通知, 4:营销 1 content true
String 内容 【阿里云】您正在登录验证,验证码{变量1},切勿将验证码泄露于他人,本条验证码有效期15分钟。
注意事项:
content中的【阿里云】签名阿里云
必须是你所申请并审核通过的签名 模板内容中变量必须是系统指定的形式,如{变量1}{变量2},且把{变量1}{变量2}当成一个整体。
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok
Json响应示例
{"code": 0,"msg": "ok"
}
2.2 修改
请求
URL:https://api.xingkongqixin.com/api/v1/sms/tpl/modify.json 请求方式:POST
请求参数
参数名 是否必填 类型 描述 示例 apikey true String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb templateId true
Long 模板ID 10 type true
String 模板类型 1:验证码, 2:通知, 4:营销 1 content true
String 内容 【阿里云】您正在登录验证,验证码{变量1},切勿将验证码泄露于他人,本条验证码有效期15分钟。
注意事项:
content中的【阿里云】签名阿里云
必须是你所申请并审核通过的签名 模板内容中变量必须是系统指定的形式,如{变量1}{变量2},且把{变量1}{变量2}当成一个整体。
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok
Json响应示例
{"code": 0,"msg": "ok"
}
2.3 列表
请求
URL:https://api.xingkongqixin.com/api/v1/sms/tpl/list.json 请求方式:GET
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb type false String 模板类型 1:验证码, 2:通知, 4:营销 1 status false String 状态:0-待审核、1-审核通过、2-审核未通过 1
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok data List 模板数据 id Long 模板ID 12 sign String 签名 阿里云 content String 模板内容 【阿里云】您正在登录验证,验证码{变量1},切勿将验证码泄露于他人,本条验证码有效期15分钟。 status Integer 状态:0-待审核、1-审核通过、2-审核未通过 1 verifyTs Long 审核时间 毫秒 1713148732000 verifyRemark String 审核信息 type Integer 模板类型 1:验证码, 2:通知, 4:营销 1
Json响应示例
{"data": [{"id": 12,"sign": "阿里云","content": "【阿里云】您正在登录验证,验证码{变量1},切勿将验证码泄露于他人,本条验证码有效期15分钟。","status": 1,"verifyTs": 1713148732000,"verifyRemark": "","type": 1},{"id": 11,"sign": "腾讯云","content": "【腾讯云】您正在登录验证,验证码{变量1},切勿将验证码泄露于他人,本条验证码有效期15分钟。","status": 0,"verifyTs": 0,"verifyRemark": "","type": 1}],"code": 0,"msg": "ok"
}
2.4 删除
请求
URL:https://api.xingkongqixin.com/api/v1/sms/tpl/del.json 请求方式:POST
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb templateId true
Long 模板ID 10
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok
Json响应示例
{"code": 0,"msg": "ok"
}
3. 短信签名
3.1 添加
请求
URL:https://api.xingkongqixin.com/api/v1/sms/sign/add.json 请求方式:POST
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb sign true
String 签名 阿里云 productUrl false String 产品链接 authorizationType false Integer 授权类型 authorizationUrl false String 授权文件
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok
Json响应示例
{"code": 0,"msg": "ok"
}
3.2 修改
请求
URL:https://api.xingkongqixin.com/api/v1/sms/sign/modify.json 请求方式:POST
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb signId true
Long 签名ID 19 sign true
String 签名 阿里云 productUrl false String 产品链接 authorizationType false Integer 授权类型 authorizationUrl false String 授权文件
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok
Json响应示例
{"code": 0,"msg": "ok"
}
3.3 列表
请求
URL:https://api.xingkongqixin.com/api/v1/sms/sign/list.json 请求方式:GET
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb status false Integer 状态: 0:待审核,1:审核通过,2:审核未通过 1
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok data List 签名数据 id Long 签名ID 19 sign String 签名 阿里云 productUrl String 产品链接 authorizationType Integer 授权类型 authorizationUrl String 授权文件 verifyTs Long 审核时间 毫秒 1713148732000 verifyRemark String 审核信息
Json响应示例
{"data": [{"id": 19,"sign": "阿里云","productUrl": "","authorizationType": 0,"authorizationUrl": "","status": 1,"verifyTs": 0,"verifyRemark": ""},{"id": 10,"sign": "叮咚云","productUrl": "","authorizationType": 0,"authorizationUrl": "","status": 0,"verifyTs": 0,"verifyRemark": ""}],"code": 0,"msg": "ok"
}
3.4 删除
请求
URL:https://api.xingkongqixin.com/api/v1/sms/sign/del.json 请求方式:POST
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb signId true
Long 签名ID 19
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok
Json响应示例
{"code": 0,"msg": "ok"
}
4. 短信发送
4.1 短信发送
请求
URL:https://api.xingkongqixin.com/api/v1/sms/send.json 请求方式:POST
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb mobileList true
String 手机号 一次最多1000个 多个手机号用英文分号;连接 15380403940;15942305452;15369848521 content true
String 短信内容 【阿里云】您正在登录验证,验证码687520,切勿将验证码泄露于他人,本条验证码有效期15分钟。
注意事项:
content中的【阿里云】签名阿里云
必须是你所申请并审核通过的签名
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok data String 消息mid 与手机号mobile组成唯一 对于短信状态获取或上行获取 YJ1L3AvnyWAZRrlG
Json响应示例
{"data": "YJ1L3AvnyWAZRrlG","code": 0,"msg": "ok"
}
5. 短信状态
5.1 短信状态获取
请求
URL:https://api.xingkongqixin.com/api/v1/sms/pull_status.json 请求方式:GET
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb pageSize false String 每次可获取短信状态的号码数量 默认20 最大100 50
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok data List 返回数据结果 mid String 消息ID YJ1L3AvnyWAZRrlG mobile String 手机号 18968192960 receiveTime String 状态时间 2024-04-10 15:49:22 reportStatus String 发送状态值, SUCCESS, FAIL SUCCESS reportDetail String 发送状态详情 DELIVRD
Json响应示例
{"data": [{"mid": "YJ1L3AvnyWAZRrlG","mobile": "18968192960","receiveTime": "2024-04-10 15:49:22","reportStatus": "FAIL","reportDetail": "BLACK"},{"mid": "YJ1L3AvnyWAZRrlG","mobile": "13656656493","receiveTime": "2024-04-10 15:49:22","reportStatus": "SUCCESS","reportDetail": "DELIVRD"}],"code": 0,"msg": "ok"
}
6. 上行
6.1 上行获取
请求
URL:https://api.xingkongqixin.com/api/v1/sms//pull_reply.json 请求方式:GET
请求参数
参数名 是否必填 类型 描述 示例 apikey true
String 短信账号key e5d692ecdfbb6cd4f21ae7a92cc2a2bb pageSize false String 每次可获取短信状态的号码数量 默认20 最大100 50
响应
名称 类型 描述 示例 code Integer code为0,表示成功,其他请参考返回值说明 0 msg String 返回结果说明 ok data List 返回数据结果 mid String 消息ID YJ1L3AvnyWAZRrlG 注意(mid+mobile组成唯一) mobile String 手机号 15380403942 content String 状态回复内容 1712738071639 replyTs Long 回复时间 SUCCESS
Json响应示例
{"data": [{"mid": "YJ1L3AvnyWAZRrlG","mobile": "15380403942","content": "YlH2T4","replyTs": 1712738071639},{"mid": "YJ1L3AvnyWAZRrlG","mobile": "18968192968","content": "YlH2T4","replyTs": 1712738071639}],"code": 0,"msg": "ok"
}