登录 注册

飞鸽API文档

API:国际短信

国际短信概括

国际短信API 是 飞鸽传书（上海）信息科技有限公司针对短信开放出的接口

采用 HTTP POST 发送模式，飞鸽API 主要针对用户为需要传送自定义内容以及号码的需求，即通过传递真实内容模板和短信内容以及短信签名实现短信发送

请求URL

http://api.feige.ee/SmsService/Inter

请求参数

  • 参数 类型 是否可空 默认 描述 示例
  • Account
    string
    N
    无
    在飞鸽应用集成中创建的短信应用账号
  • Pwd
    string
    N
    无
    飞鸽应用集成中的短信请求接口密钥
    web平台：首页接口密钥
  • Content
    string
    N
    无
    这里的content为变量值，多个变量以||进行分隔，按顺序排列
    如：变量1||变量2
  • Mobile
    string
    N
    无
    手机号码 格式(区号+手机号码) 例如：8615800000000，其中86为中国的区号，区号前不使用00开头,15800000000为接收短信的手机号码 多个号码以逗号分隔 最多200个号码
  • TemplateId
    long
    N
    无
    短信免审模板ID,id可在管理后台获取、添加、编辑
  • SignId
    long
    N
    无
    短信签名建议2-8字符,id可在管理后台获取、添加、编辑
  • SenderId
    string
    Y
    fgsms
    发送者 类似于国内短信的1069... 2-10数字或字母 具体以收到为准

协议

HTTP  POST

编码格式

UTF-8

Content-Type

application/x-www-form-urlencoded

是否与要授权

是

参阅 API 授权和验证机制

错误代码

参阅 API 错误代码

返回值格式

json默认 >

{
  "Code":0,
  "Message":"OK",
  "SendId":"2016072909264497197473179",
  "InvalidCount":0,
  "SuccessCount":1,
  "BlackCount":0
}

返回值参数说明

  • 参数 描述 描述
  • SendId
    短信回执编号，为唯一识别码，用户可通过此编号获取记录详情
    默认格式如：2016080111261216589966449
  • InvalidCount
    无效号码数量
    可能是非手机号码如02161531765
  • SuccessCount
    有效号码数量
    一般为该批次计费条数
  • BlackCount
    黑名单号码数量
    黑名单号码数量
  • Code
    短信回执状态码，判断成功失败的标志
  • Message
    短信回执状态描述