wiki:pconline_4.1.0/interface

Version 4 (modified by wuchangbo, 11 years ago) (diff)

--

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 个人中心 - 登陆接口

 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

2.2 个人中心 - 验证码接口

   URL:http://captcha.pconline.com.cn/captcha/v.jpg
       请求方式:HTTP GET
       说明:获取用户验证码

2.3 首页 - 栏目列表

Android: http://mrobot.pconline.com.cn/configs/pconline_v6_cms_android_channel_tree
       请求方式:HTTP GET
       说明:获取栏目列表(新增图赏栏目,放在news对象第六位)
       android图赏tab:858,   ios图赏tab:859
       返回(json格式)
       {
    "news": [
        [
            "999",
            "头条",
            "528"
        ],
        [
            "2",
            "新闻",
            "530"
        ],
        [
            "4",
            "评测",
            "532"
        ],
        [
            "10",
            "直播",
            "531"
        ],
        [
            "200",
            "手机",
            "533"
        ],
        [
            "0",
            "图赏",
            "858"
        ],
        [
            "120",
            "DIY",
            "540"
        ],
        [
            "100000",
            "行情",
            "536"
        ],
        [
            "3",
            "导购",
            "535"
        ],
        [
            "300",
            "笔记本",
            "537"
        ],
        [
            "301",
            "超极本",
            "534"
        ],
        [
            "400",
            "平板",
            "538"
        ],
        [
            "500",
            "相机",
            "539"
        ],
        [
            "600",
            "家电",
            "541"
        ],
        [
            "700",
            "MID",
            "542"
        ],
        [
            "800",
            "摄像机",
            "543"
        ],
        [
            "130",
            "企业",
            "545"
        ],
        [
            "900",
            "电视",
            "544"
        ],
        [
            "1000",
            "软件",
            "721"
        ]
    ],
    "events": [],
    "product": [],
    "area": [
        [
            "100000",
            "全国",
            "6978"
        ],
        [
            "110000",
            "北京",
            "6978"
        ],
        [
            "310000",
            "上海",
            "6978"
        ],
        [
            "440100",
            "广州",
            "6978"
        ],
        [
            "440300",
            "深圳",
            "6978"
        ],
        [
            "500000",
            "重庆",
            "6978"
        ],
        [
            "210000",
            "辽宁",
            "6978"
        ],
        [
            "350000",
            "福建",
            "6978"
        ],
        [
            "330000",
            "浙江",
            "6978"
        ],
        [
            "450000",
            "广西",
            "6978"
        ],
        [
            "510100",
            "成都",
            "6978"
        ],
        [
            "420100",
            "武汉",
            "6978"
        ],
        [
            "120105",
            "河北",
            "6978"
        ],
        [
            "230000",
            "黑龙江",
            "6978"
        ],
        [
            "220403",
            "西安",
            "6978"
        ],
        [
            "370000",
            "山东",
            "6978"
        ],
        [
            "430000",
            "湖南",
            "6978"
        ],
        [
            "410000",
            "河南",
            "6978"
        ],
        [
            "360000",
            "江西",
            "6978"
        ],
        [
            "810000",
            "香港",
            "6978"
        ],
        [
            "440400",
            "珠海",
            "6978"
        ],
        [
            "340000",
            "安徽",
            "6978"
        ],
        [
            "460000",
            "海南",
            "6978"
        ],
        [
            "320000",
            "江苏",
            "6978"
        ],
        [
            "441900",
            "东莞",
            "6978"
        ],
        [
            "120000",
            "天津",
            "6978"
        ],
        [
            "330200",
            "宁波",
            "6978"
        ],
        [
            "440600",
            "佛山",
            "6978"
        ],
        [
            "210200",
            "大连",
            "6978"
        ],
        [
            "130600",
            "保定",
            "6978"
        ],
        [
            "441700",
            "阳江",
            "6621"
        ]
    ]
}