| | 1 | [[TOC]] |
| | 2 | |
| | 3 | == 1.基本约定 == |
| | 4 | {{{ |
| | 5 | 接口通用参数 |
| | 6 | req_enc=utf-8(必须放url后面) |
| | 7 | resp_enc=utf-8(必须放url后面) |
| | 8 | common_session_id=xxxx(以cookies中的优先) |
| | 9 | |
| | 10 | 接口URL: 接口URL |
| | 11 | 必填参数:参数名=xxx(多种情况用括号解析) |
| | 12 | 非必填参数:参数名=xxx(多种情况用括号解析) |
| | 13 | 说明文档参数:添加某特定参数可以直接看接口文档 |
| | 14 | 是否需要登录:是,否 |
| | 15 | 返回格式:json,ssi,xml |
| | 16 | 缓存方式:接口缓存,对象缓存 |
| | 17 | 缓存时间:缓存时间 |
| | 18 | 返回结果:结果可能情况 |
| | 19 | }}} |
| | 20 | |
| | 21 | == 2.接口列表 == |
| | 22 | === 2.1 [=#point201 个人中心 - 系统消息列表] === |
| | 23 | {{{ |
| | 24 | 备注:此接口返回系统消息列表 |
| | 25 | mrobot接口:暂无 |
| | 26 | 后端接口:http://bip.pconline.com.cn/intf/sysnotice.jsp?act=find&groupType=0&common_session_id=C2BE11FFA56EBACBD70F9A0C5BF0F10CE1368EA71ABF0802&resp_enc=UTF-8&siteId=1&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8 |
| | 27 | HTTP请求方式:get |
| | 28 | 是否需要登录:是 |
| | 29 | 返回格式:json |
| | 30 | 缓存方式:无 |
| | 31 | 缓存时间:无 |
| | 32 | 请求参数: |
| | 33 | act=find |
| | 34 | siteId=网站ID(1是电脑网,2是汽车网,3是游戏网,4是女性网,5是亲子网,6是家居网) |
| | 35 | status=-1(-1为已读和未读,0表示未读,1表示已读) |
| | 36 | typeIds=2004 |
| | 37 | groupType=消息分组,默认全部,开发人员提供 |
| | 38 | status=0是未读,1是已读,默认-1是全部 |
| | 39 | startDate=开始时间 |
| | 40 | endDate=结束时间 |
| | 41 | beforeDay=在某个时间前 |
| | 42 | pageNo=页码 |
| | 43 | pageSize=一页条数,默认20,最大500 |
| | 44 | noTemplate=true不需要模板,false需要模板,默认是false |
| | 45 | 返回参数: |
| | 46 | { |
| | 47 | total: 总的条数 |
| | 48 | pageNo: 页码 |
| | 49 | pageCount: 页数 |
| | 50 | pageSize: 每页条数 |
| | 51 | resultList:{ |
| | 52 | id: 消息ID |
| | 53 | type: { //消息类型 |
| | 54 | name: 消息类型名称 |
| | 55 | id: 消息分类ID |
| | 56 | description: 描述 |
| | 57 | siteId: 网站ID |
| | 58 | templateId: 模板ID |
| | 59 | groupType: 分组ID |
| | 60 | } |
| | 61 | content: 模板内容 |
| | 62 | createTime: 发送消息时间戳 |
| | 63 | status: 状态 |
| | 64 | accountId: 接收消息人 |
| | 65 | siteId: 网站ID |
| | 66 | typeId: 分类ID |
| | 67 | senderId: 发送者ID |
| | 68 | groupSend: 是否群发 |
| | 69 | groupType: 消息分组 |
| | 70 | resultText: 操作结果 |
| | 71 | } |
| | 72 | }}} |
| | 73 | |
| | 74 | === 2.2 [=#point202 个人中心 - 清零系统消息] === |
| | 75 | {{{ |
| | 76 | 备注:此接口清零系统消息(后端接口需要确认,目前使用Web版个人中心接口) |
| | 77 | mrobot接口:暂无 |
| | 78 | 后端接口:http://my.pconline.com.cn/bip/intf/sysnotice.jsp |
| | 79 | HTTP请求方式:post |
| | 80 | 是否需要登录:是 |
| | 81 | 返回格式:json |
| | 82 | 缓存方式:无 |
| | 83 | 缓存时间:无 |
| | 84 | 请求参数:请求参数为json |
| | 85 | |
| | 86 | {"act":"deleteAll","siteId":1} |
| | 87 | |
| | 88 | }}} |