Doo Cloud

获取短信状态报告

GET

/client-sms/v2/sms/get-rpt

请求方式可以是GET，GET参数格式以路径后缀传递
接口请求地址：GET /client-sms/v2/sms/get-rpt

请求参数

Header 参数

Finovy-Access-Token

string

令牌-口令

必需

示例值:

zabAehE5uHaAAGBiPIac3j

Body 参数multipart/form-data

msgId

string

必需

短信平台返回的回执流水号，可在发送短信时保存接口返回值

示例值:

249474272274174009

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://smsapi-formal.cloud.doo.com/client-sms/v2/sms/get-rpt' \
--header 'Finovy-Access-Token: zabAehE5uHaAAGBiPIac3j' \
--form 'msgId="249474272274174009"'

返回响应

🟢200成功

application/json

Body

result

integer

获取状态报告请求处理结果

必需

0：成功，非0：失败，详见错误码

desc

string

必需

rpts

array [object {8}]

必需

msgId

integer

平台流水号

必需

短信回执流水号

custId

string

用户自定义流水号

必需

用户自定义流水号,状态返回值内将包含用户自定义流水号

costNum

integer

长短信拆分的总条数

必需

mobile

string

收信手机号

必需

sendTime

string

状态报告返回时间

必需

YYYY-MM-DD HH:MM:SS

status

integer

接收状态

必需

状态(pending等待回执，success成功，fail失败)

errDesc

string

状态报告错误代码

必需

exData

string

必需

下行时填写的exdata

示例

成功示例异常示例

{
  "code": 0,
  "success": true,
  "data": {
    "msgId": "uEWOjcXVaasszMe0pkr3Ud",
    "custId": "885245663",
    "exData": "zxcvbbnnd",
    "costNum": 1,
    "mobile": "18563969992",
    "sendTime": "2024-02-06 19:04:00",
    "status": "success",
    "errDesc": null
  },
  "msg": "success",
  "traceId": "f3f13645c8df4b02a70713e2b39f652f.2360.17083496334650029"
}

修改于 2025-04-15 02:56:16

发送短信

查询短信发送明细列表