NextOTP 消息接口文档

响应

  1. 本文档所有接口 HTTP 状态码固定为 200，无论是成功或失败
  2. 响应失败时，响应内容结构为 {"status": -1, "desc": "Authentication failure"}

接口

1.发送消息

说明

URL

GET https://api.bak.nditech.dev/sendsms?account={account}&password={password}&smstype=0&sender={sender}&numbers={numbers}&content={content}

URL 参数

参数 必需 示例 说明
account Yes someone 账户
password Yes pass123 密码
smstype Yes 0 固定为 0
sender Yes Google 品牌词
numbers Yes 6282163333333 接收号码
需要带国家码
content Yes Your code is 12345 消息内容
若为验证码消息，则会自动提取验证码

响应

{
  "status": 0,  // 0 表示成功
  "success": 1, // 成功条数
  "fail": 0,    // 失败条数
  "array": [    // 发送详情
    [
      "6282163550267", // 消息接收号码
      389158028        // 消息 ID
    ]
  ]
}

2.送达报告

说明

此接口响应只需返回状态码 200 即可，无需返回任何其他内容

URL

POST https://your.api.accepting.webhook

请求头

Content-Type: application/json

请求体

{
  "array": [ // 送达报告列表，一次可能返回多条
    [
      389158028,       // 消息 ID
      "6282163550267", // 接收号码
      20230801123015,  // 接收时间
      0,               // 送达结果。0: 成功, 其他: 失败
      "READ"           // 结果描述
    ]
  ],
  "cnt": 1,        // 报告条数
  "type": "report" // 固定值
}

3.查询余额

URL

GET https://api.bak.nditech.dev/getbalance?account={account}&password={password}

响应

{
  "status": 0,        // 0 表示成功
  "balance": "99993", // 余额
  "gift": "0.000000"  // 赠送额度
}

4.查询消息发送状态

URL

GET https://api.bak.nditech.dev/getreport?account={account}&password={password}&ids=988423423

URL 参数

参数 必需 示例 说明
account Yes someone 账户
password Yes pass123 密码
ids Yes 0 消息 ID，多个 ID 之间以英文逗号分隔，最多 200 个

响应

{
  "status": 0, // 0 表示成功
  "array": [
    [
      988423423,                          // 消息 ID
      "EC104E956C86F8260C2FB14A9A4A03F9", // 号码 Hash
      20250815164917,                     // 发送时间
      0,                                  // 发送状态。0: 发送成功, 1: 未发送, 2: 正在发送, 其他: 失败
      20250815164917,                     // 送达时间
      3                                   // 送达状态。0: 不需要报告, 1: 已经发送但是还未送达, 2: 送达失败, 3: 送达成功, 其他: 失败
    ]
  ],
  "success": 1,
  "fail": 0,
  "unsent": 0,
  "sending": 0,
  "nofound": 0,
  "deliverSuc": 1,
  "deliverFail": 0,
  "deliverTimeout": 0
}