一对一发送接口

接口说明

本接口用于向不同手机号码发送不同内容的短信，如工资条、账单明细等，适用于需要完全个性化内容的场景。

接口地址

POST http://cloud.thinksms.cn/p2p.aspx (UTF-8编码)

Content-Type: application/x-www-form-urlencoded

提示：适用于工资条发送、个性化账单通知、会员专属消息等需要为每个用户发送不同内容的场景

请求参数

参数名称	含义	类型	必填	说明
action	请求动作	string	是	固定为:send
userid	企业ID	string	是	企业ID（登陆后台-客户管理-我的信息）
account	帐号	string	是	短信帐号
password	密码	string	是	登陆密码
mobileContentList	号码内容列表	string	是	号码和内容间用tab制表符隔开。每行一个号码和内容。如果内容里面带有tab，使用/t替换。内容里面有回车换行，使用/r/n替换
sendTime	定时发送时间	string	否	为空表示立即发送，定时发送格式:YYYY-MM-DD HH:mm:ss
extno	扩展子号	string	否	请先询问配置的通道是否支持扩展子号，如果不支持，请填空。子号只能为数字，且最多10位数。

请求示例

一对一发送请求：

http://cloud.thinksms.cn/p2p.aspx?action=send&userid=客户ID&account=账号&password=密码&mobileContentList=号码内容列表&sendTime=&extno=
            

号码内容列表格式：

13800138000    【云消息】尊敬的会员，您的订单1234已发货
15900159000    【云消息】您的注册验证码：8899，5分钟内有效
            

JSON格式请求（可选）

部分接口支持JSON格式请求：

{
    "action": "send",
    "userid": "客户ID",
    "account": "账号",
    "password": "密码",
    "mobileContentList": "13800138000\t【云消息】尊敬的会员，您的订单1234已发货\n15900159000\t【云消息】您的注册验证码：8899，5分钟内有效",
    "sendTime": "",
    "extno": ""
}
            

响应数据

XML格式响应：

JSON格式响应（如请求时指定rt=json参数）：

{
    "ReturnStatus": "Success",
    "Message": "ok",
    "RemainPoint": 109346,
    "TaskID": 365,
    "SuccessCounts": 2
}
            

字段说明

returnstatus/ReturnStatus 返回状态值：成功返回Success，失败返回：Faild

message/Message 返回信息提示

remainpoint/RemainPoint 返回余额

taskID/TaskID 返回本次任务的序列ID

successCounts/SuccessCounts 成功短信数：当成功后返回提交成功短信数

常见错误信息

错误信息	说明
号码内容列表格式错误	mobileContentList参数格式不正确
内容包含特殊字符未转义	内容中包含tab或换行符未正确转义
号码数量与内容数量不匹配	号码和内容行数不一致