欢迎访问

深圳新锐信息科技有限公司

网站

1.1.    短信restful接口

1.1.1.      短信下行

接口地址:url/webService/restSmsService/sendSms.json

例如:http://sz.iveng.com/sms/webService/restSmsService/smsService/sendSms.json (get方式)

例如:http://sz.iveng.com/sms/webService/restSmsService/smsService/sendSmsByPost.json (post方式)

说明:该地址是短信服务平台提供的服务地址,其中只需要修改url部分。

请求参数定义

功能

发送短信(发送内容相同的一条或者多条短信)

输入参数说明

account:帐号(短信服务平台提供)

password:密码(短信服务平台提供,需用MD5加密32位,加密后字母全部为小写,例如:“123.com

加密后应该是“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确

smsType:短信业务类型(短信服务平台提供)

mobile:手机号码(多个以英文逗号隔开)

content:接收短信内容

smsId:短信标识Id(用于匹配回执,可选)

sendTime:短信定时发送时间(可选)

subCode:扩展子码(可选)

templateId:模板ID(可选)

输出说明

json格式,如下:

{
  "smsId": "62c6f3ab-b572-4297-b177-60deafbeff51",
  "subStat": "r:000",
  "subStatDes": "处理成功",
  "resDetail": [
    {
      "phoneNumber": "13800138000",
      "stat": "r:000",
      "statDes": "提交成功"
    },
    {
      "phoneNumber": "13800138001",
      "stat": "r:000",
      "statDes": "提交成功"
    }
  ]
}

说明:

subStat:值为r:000时表示该请求被成功受理;其他值(1.1.5)则表示该请求受理失败,此时将不会出现resDetail标签。

smsId:短信标识,如果客户端请求时,填写了smsId,则该值等于请求时客户端的smsId;否则该值为短信服务平台自动生成。

Java代码demo

public static void main(String[] args) throws Exception {

      Map<String, Object> params = new HashMap<String, Object>();

      params.put("account", "xx");

      params.put("password", "f561aaf6ef0bf14d4208bb46a4ccb3ad");

      params.put("smsType", "xx");

      params.put("mobile", "189xxxxxx");

      params.put("contont", "xx】内容123");

      String res = HttpRequest.post("http://sz.iveng.com/sms/webService/restSmsService/smsService/sendSmsByPost.json", params, "UTF-8");

   }

1.1.2.      短信上行

接口地址:url/webService/restSmsService/smsService/getReply.json

例如:http://sz.iveng.com/sms/webService/restSmsService/smsService/getReply.json

说明:该地址是短信服务平台提供的服务地址,其中只需要修改url部分。

请求参数定义

功能

获取上行短信。

输入参数说明

account:帐号(短信服务平台提供)

password:密码(短信服务平台提供,需用MD5加密32位,加密后字母全部为小写,例如:“123.com

加密后应该是“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确

输出说明

json格式,如下:

{

  "revStat": "r:000",

  "revStatDes": "获取上行短信条数:2",

  "resDetail": [

    {

      "phoneNumber": "13800138001",

      "content": "上行1",

      "subCode": null,

      "revTime": 1520225508000,

      "demo": null

    },

    {

      "phoneNumber": "13800138000",

      "content": "上行2",

      "subCode": null,

      "revTime": 1520225508000,

      "demo": null

    }

  ]

}



1.1.3.      短信状态报告

接口地址:url/webService/restSmsService/smsService/getReport.json

例如:http://sz.iveng.com/sms/webService/restSmsService/smsService/getReport.json

说明:该地址是短信服务平台提供的服务地址,其中只需要修改url部分。

请求参数定义

功能

发送短信(发送内容相同的一条或者多条短信)

输入参数说明

account:帐号(短信服务平台提供)

password:密码(短信服务平台提供,需用MD5加密32位,加密后字母全部为小写,例如:“123.com

加密后应该是“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确

输出说明

json格式,如下:

{

  "subStat": "r:000",

  "subStatDes": "获取状态报告记录数:2",

  "resDetail": [

    {

      "smsId": "62c6f3ab-b572-4297-b177-60deafbeff51",

      "phoneNumber": "13800138000",

      "stat": "r:004",

      "statDes": "-1100",

      "revTime": "2018-03-05 12:31:53"

    },

    {

      "smsId": "62c6f3ab-b572-4297-b177-60deafbeff51",

      "phoneNumber": "13800138001",

      "stat": "r:004",

      "statDes": "-1100",

      "revTime": "2018-03-05 12:32:15"

    }

  ]

}

1.1.4.      账户余额

接口地址:url/webService/restSmsService/smsService/getBalance

例如:http://sz.iveng.com/sms/webService/restSmsService/smsService/getBalance.json

说明:该地址是短信服务平台提供的服务地址,其中只需要修改url部分。

请求参数定义

功能

查询账号余额。

输入参数说明

account:帐号(短信服务平台提供)

password:密码(短信服务平台提供,需用MD5加密32位,加密后字母全部为小写,例如:“123.com

加密后应该是“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确

输出说明

json格式,如下:

{
  "revStat": "r:000",
  "revStatDes": "您的短信余额为:1338802 ",
  "demo": null
}


 
<
线

商盟客服 >
您好,欢迎莅临我们的网站,欢迎咨询...

  • 黄经理: 点击这里给我发消息