Changes between Version 20 and Version 21 of doc/interface/platform

Timestamp:

07/02/2012 11:30:32 AM (14 years ago)

Author:

wangjianqiang

Comment:

--

doc/interface/platform

@@ -1 +1 @@
 = 平台接口设计 =
+
+
+== 平台注册接口(魔方专供) ==
+
+接口地址：
+{{{
+  http://pns.imofan.com/sender/register
+}}}
+
+接口请求参数定义：
+||参数名||说明||
+||appkey||应用的唯一标识id，由魔方系统生成||
+
+注意：
+* 参数必须用POST方式提交
+* 平台提供给客户端的api包发出请求的user-agent固定为：imofan pns client，若判断user-agent不匹配，则不予注册
+  
+接口响应JSON格式定义：
+{{{
+  {
+    "stat":      1,
+    "appsecret": "h4534getr34re",
+    "info":      "注册失败时的额外信息"
+  }
+}}}
+
+返回值定义：
+||返回值||说明||
+||stat||取值为：1 注册成功，0 已注册过，-1 注册失败||
+||appsecret||第三方应用服务端验证密码，进行推送时使用||
+||info||包含额外的说明信息，用于stat为-1时平台所给的错误提示||
+
 
 == 设备注册接口 ==
@@ -77 +109 @@
 ||参数名||说明||
 ||appkey||应用的唯一标识id，由魔方系统生成||
-||appsecret||应用服务端验证密码，由魔方生成或者用户自己在魔方中设置||
+||appsecret||应用服务端验证密码||
 ||token||推送平台分配给该客户端的推送Token||
 ||message||要推送的消息||