Changes between Initial Version and Version 1 of pconline_4.1.0/interface

Timestamp:

04/17/2015 02:40:05 PM (11 years ago)

Author:

wuchangbo

Comment:

--

pconline_4.1.0/interface

@@ +1 @@
+[[TOC]]
+
+== 1.基本约定 ==
+{{{
+接口通用参数
+req_enc=utf-8(必须放url后面)
+resp_enc=utf-8(必须放url后面)
+common_session_id=xxxx(以cookies中的优先)
+
+接口URL: 接口URL
+必填参数：参数名=xxx(多种情况用括号解析)
+非必填参数：参数名=xxx(多种情况用括号解析)
+说明文档参数：添加某特定参数可以直接看接口文档
+是否需要登录：是,否
+返回格式：json,ssi,xml
+缓存方式：接口缓存，对象缓存
+缓存时间：缓存时间
+返回结果：结果可能情况
+}}}
+
+== 2.接口列表 ==
+=== 2.1 [=#point201 个人中心 - 登陆接口] ===
+{{{
+
+ URI：/rest/login.jsp
+        请求方式：HTTPS POST
+        说明：用户登录接口
+        参数：
+          1). username ：用户名
+          2). password ：密码
+          3). captcha ：验证码（密码错误大于等于3次需要输入验证码）
+             （验证码图片请求时会回设cookie：captcha，表单提交的时候带回cookie才能校验通过）
+          4). auto_login：cookie过期时间，不填默认为15天，最大不超过90天
+        返回(json格式)：
+            失败：
+            {"status":" + ex.getStatus() + ","message":""+ ex.getMessage() + ""}
+            成功：
+            {"status":0,"message":"ok","session":"abcdefghijk","userId":"123456 ","common_session_id":"abcdefghijk"}
+           说明：
+               status : 处理状态(0 为成功,其他为失败)
+               message : 相关状态信息
+               session : common_session_id值
+               common_session_id : common_session_id值
+               userId: 当前登录用户id
+}}}