400-6622-111 登录 注册

飞鸽API文档

API:主动获取上行

主动获取上行

获取上行API 是飞鸽传书（上海）信息科技有限公司针对短信开放出的接口
采用 HTTP POST 调用模式，飞鸽API 该接口主要用于获取短信回复的上行信息 限定10S一次

请求URL

https://data.4321.sh/sms/moupgrade

请求参数

  • 参数 类型 是否可空 默认 描述
  • apikey
    string
    N
    无
    通知/营销短信产品Api接口账号
  • secret
    string
    N
    无
    通知/营销短信产品Api接口秘钥
  • count
    int
    Y
    10
    获取上行条数 默认10条 [10,100]

协议

HTTP POST

编码格式

UTF-8

Content-Type

application/json

是否需要授权

是

参阅 API 授权和验证机制

错误代码

参阅 API 错误代码

返回值格式

json默认

{
 "data": [{
 "msg_no": "短信批次号",
 "sms_content": "短信内容",
 "content": "收到",
 "ext_no": "10001",
 "time": 1624039239
 }],
 "code": 0,
 "msg": "OK"
}

返回值参数说明

  • 参数 描述 示例
  • data
    上行列表
    为上行集合列表
  • msg_no
    短信批次号
    下发时短信的批次号
  • sms_content
    短信内容
    下发时短信内容
  • content
    上行内容
    上行接收到的短信内容
  • time
    1477366109(2016-10-25 11:28:29)
    上行发送的时间(时间戳)
  • mobile
    接收对应的手机号码
  • ext_no
    上行的扩展号码
  • code
    接口回执状态码，判断成功失败的标志
  • msg
    接口回执状态描述