Changes between Version 3 and Version 4 of AndroidPushInterface

Timestamp:

10/10/2012 05:14:35 PM (14 years ago)

Author:

wangjianqiang

Comment:

--

AndroidPushInterface

@@ -17 +17 @@
 注意：
 * 参数必须用POST方式提交
-* 平台提供给客户端的api包发出请求的user-agent固定为：imofan pns client，若判断user-agent不匹配，则不予分配token
+* 平台提供给客户端的api包发出请求的user-agent固定为：imofan pns client，若判断user-agent不匹配，则返回404
   
 接口响应JSON格式定义：
@@ -30 +30 @@
 返回值定义：
 ||返回值||说明||
-||stat||取值为：1 Toekn分配成功，-1 分配失败||
+||stat||请求状态，取值为：1 Toekn分配成功，-1 分配失败||
 ||token||推送平台分配给该客户端的推送Token||
 ||info||包含额外的说明信息，用于stat为-1时平台所给的错误提示||
+
+
+== 获取推送消息接口 ==
+
+接口地址：
+{{{
+  http://p.imofan.com/notification/{appkeys}/{ver_code}
+}}}
+
+接口请求参数定义：
+||参数名||说明||
+||appkeys||需要接收推送的应用的app_key组合字符串，app_key之间用逗号分离||
+||ver_code||对appkeys进行不可逆加密后的校验码||
+
+注意：
+* 参数必须用POST方式提交
+* 平台提供给客户端的api包发出请求的user-agent固定为：imofan pns client，若判断user-agent不匹配，则返回404
+  
+接口响应JSON格式定义：
+{{{
+  {
+    "stat": 1,
+    "info": "获取推送消息失败时的额外信息",
+    "notification": [
+        {
+            "id": 3516,
+            "app_key": "b5d3828499d0590600000006",
+            "app_ver": ">=320",
+            "os_ver": "<2.2",
+            "token": "188fa88e3d821a4867b43d74dd1d4905",
+        },
+        ...
+    ]
+  }
+}}}
+
+返回值定义：
+||返回值||说明||
+||stat||请求状态，取值为：1 推送消息获取成功，-1 获取失败||
+||info||包含额外的说明信息，用于stat为-1时平台所给的错误提示||
+||id||消息id||
+||app_key||消息针对的应用appkey||
+||app_ver||消息针对的应用版本，可用>320、>=320、=320、<=320、<320五种形式，其中320为Android应用version code，必须是整数值||
+||os_ver||消息针对的操作系统版本，可为>2.0、>=2.1、=3.0、<=4.0、<4.1五种形式，其中比较符后面的数字只能是两段式格式，不做更细的划分||
+||token||消息针对的token，只有token相同的客户端能收到该条消息||