普通接口

普通接口提供基础的发送方式,数据以明文传输,并不能保障数据安全,如果有安全性需求,请选用安全接口。

普通接口所有参数均通过post或get参数提交,注意:部分参数如内容需要进行URLENCODE转码保证数据能够正常传输。

字符集:普通接口传出数据仅支持UTF-8字符集编码;

状态报告获取接口

此接口为客户获取状态报告提供支持。

请求

链接

http://ip:port/fms/normal/getFMSReport

参数

参数 类型 描述
appId String 用户Appid(必填)
requestTime long 请求时间(必填)
格式:时间毫秒数
安全验证字段,防止同一个请求重复提交;
闪推平台根据requestTime与requestValidPeriod共同判断请求是否有效,针对无效的请求,闪推平台响应错误;
判断方法:请求时间 + 请求有效时间> 当前时间 ? 有效 : 无效;
requestValidPeriod int 请求有效时间(必填)[单位:秒]
描述同上
number int 获取数量(选填)
最多500个,默认500个
sign String 签名(必填)格式:md5(appId+ secretKey + requestTime)

示例

1、将参数拼装成json串

  •  {
    "appId":"EUCP-EMY-TEST-XXXX",
    "number":300,
    "requestTime":1490588340964,
    "requestValidPeriod":30,
    "sign":"f9f025756424b5c1a96363630a49dd89"
    }
    

2、将json串转化为UTF-8编码的byte数组

  • Byte[] data = json.toBytes[“UTF-8”];
    

3、通过http post方法传输

  • Byte[] response = http.post(url,data);
    

详见闪推接口demo

响应

响应数据格式为Json

参数

参数 类型 传输方式 描述
result String http头信息传输 请求状态码,详见本文档《接口状态码表》
当result不是SUCCESS时,不会响应下面参数数据。
mobile String 手机号(必填)
fmsId String 消息ID(选填)
customFmsId String 自定义消息ID(选填)
state String 状态(必填),详见本文档《4.状态报告状态码表》
desc String 状态描述(选填)
receiveTime String 状态报告返回时间(必填)
格式:yyyy-MM-dd HH:mm:ss
submitTime String 信息提交时间(必填)
格式:yyyy-MM-dd HH:mm:ss

示例

1、从http头信息获取请求状态,如果code不是SUCCESS,不用进行下面几步

  • String code = http.getHead("result");
    

2、从响应流获取响应数据

  • Byte[] data = Response.getdata();
    

3、将数据转换成JSON串

  • String json = new String(data,"UTF-8");
     [
    	{
    		"mobile":"159xxxxxxxx ",
    		"fmsId":"20180392833833891100",
    		"customFmsId":"1553885000011111",
    		"state":" DELIVRD",
    		"desc":"成功",
    		"receiveTime ":"2018-03-15 12:00:00",
    		"submitTime":"2018-03-15 12:00:00"
    		},{
    		"mobile":"159xxxxxxxx ",
    		"fmsId":"20180392833833891101",
    		"customFmsId":"1553885000011112",
    		"state":" DELIVRD",
    		"desc":"成功",
    		"receiveTime ":"2018-03-15 12:00:00",
    		"submitTime":"2018-03-15 12:00:00"
    	}
    ]
    
TOP