Skip to content

短信回执回调

momi00 edited this page Nov 25, 2024 · 11 revisions

简要描述:

  • 短信回执(DR)推送

请求URL:

  • DR推送的Http接口地址(由用户提供)
  • 例如: http://106.15.34.94:8989/sms/testDr

请求方式:

  • POST x-www-form-urlencoded
  • 2023/5/4之前注册的客户,参数在url;之后的客户,参数在 post body 。

参数:

参数名 必选 类型 说明
phone string 手机号
status string 状态代码:2:成功下发,其他数字都未下发成功
result string 回执内容: DELIVRD\ UNDELIV
drtime string 回执报告时间,格式为:yyyy-MM-dd HH:mm:ss
messageid string 短信id,对应的短信提交成功得到的id
currency string price的币种 如:CNY\ USD
price string 对应币种的短信单价
rate string 美元对人民币汇率 如:7.05
sendtime string 发送时间,格式为:yyyy-MM-dd HH:mm:ss
size string 计费条数
ext string 透传字段,该字段为短信下行发送接口中的非必填字段,填写后在回执中会原样返回,仅支持http

推送示例

2023/5/24 之前注册的客户,url 传递参数

POST http://106.15.34.94:8080/sms/testDr?result=DELIVRD&size=1&phone=6282167624806&rate=6.4845&price=0.045&messageid=b308d94a73f94e6d84ae975c41f4b2a6&drtime=2021-02-26 10:01:15&currency=USD&sendtime=2021-02-26 10:01:15&status=2

2023/5/24 之后注册的客户,post body

POST http://106.15.34.94:8080/sms/testDr
Content-Type: x-www-form-urlencoded

result=DELIVRD&size=1&phone=6282167624806&rate=6.4845&price=0.045&messageid=b308d94a73f94e6d84ae975c41f4b2a6&drtime=2021-02-26 10:01:15&currency=USD&sendtime=2021-02-26 10:01:15&status=2

回执状态对应码

public static final int DELIVRD = 2; // 成功
public static final int UNDELIV = 5; // 失败
public static final int REJECTD = 6; // 拒绝
public static final int EXPIRED = 7; // 过期
public static final int DELETED = 8; // 删除
public static final int DND = 9; // 免打扰
public static final int ESME_RINVSRCADR = 11; // 错误发件人
public static final int UNKNOWN = 12; // 未知

用户返回值
成功返回字符串:success 失败返回字符串:error

备注
说明:DR只推送一次,如果需要重新获取可以手动拉取DR处理

简介

短信

语音

云呼叫中心(NXLink)

云呼叫中心(AI自动外呼)

Flash Call

短链

邮件验证码

DID号码

通用

号码检测

WhatsApp

Viber

Zalo ZNS

Super Message API

隐私号(旧)

PNS

坐席(旧版)

NXLINK(HKG)

NXLINK(IDN)

NXLINK(CHL)

AI Agent

RCS

Clone this wiki locally