[[TOC]] = 电脑网4.5.0接口文档 = == 1.接口列表 == ---------- === 1.1 兑吧积分商城接口=== 接口:http://www.duiba.com.cn/autoLogin/autologin [[BR]] **缓存策略** >兑吧免登录url经过签名,该url地址5分钟失效,请务必在生成地址后立即使用,使用后用户即可进入积分商城,登录状态24小时有效。 **提交方式** > GET **是否登录** > 是 **参数** ||= 参数名 =||= 类型 =||= 限制长度 =||= 默认值 =||= 是否必需 =||=说明=|| || uid ||string|| 255 || || 是 ||用户id (用not_login作为uid标记游客用户)|| || credits || long || 20 || || 是 ||用户积分余额|| || appKey ||string|| 255 || || 是 ||接口appKey,应用的唯一标识|| || timestamp || long || 20 || || 是 ||1970-01-01开始的时间戳,毫秒为单位。|| || sign ||string|| 255 || || 是 ||MD5签名|| || redirect ||string|| 255 || || 否 ||登陆成功后的重定向地址,可以直达积分商城的某个内页|| **返回** 积分商城返回是一个网页 === 1.2 文章发评论接口增加机型字段=== 接口:http://cmt.pconline.com.cn/action/comment/create_utf8.jsp [[BR]] **说明** > 原文章发评论接口增加传入用户机型字段和用户自定义机型字段 [[BR]] **缓存时间** >无 **提交方式** >POST **是否登录** > 是 **新增参数** ||= 参数名 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| || model ||string|| || 是 ||用户实际的手机型号|| || custom ||string|| || 是 ||用户自定义的手机型号|| === 1.3 评论列表接口返回自定义机型字段=== 接口:http://mrobot.pconline.com.cn/v3/cmt/new_topics/ {topicId} [[BR]] 示例:http://mrobot.pconline.com.cn/v3/cmt/new_topics/13440544?pageNo=1&pageSize=20&reverse=0&articleId=7571361 **说明** > 文章评论列表接口返回用户自定义机型字段 [[BR]] **缓存时间** >无 **提交方式** >GET **是否登录** > 否 **返回** {{{#!java { { "comments": [ { "1": { "client": "3", "content": "新品叫:New iPad Air Pro Mini", "face": "http://i7.3conline.com/images/upload/upc/face/56/09/65/0/5609650_50x50", "floor": "5", "from": "来自炫酷爱疯6", "id": "40957155", "name": "LinSing", "time": "2016-02-26 10:39:16", "userId": "5609650" }, "current": "1", "expand": false, "support": "1" } ], "docUrl": "http://mrobot.pconline.com.cn/v3/cms/articles/7571361", "hot-comments": [], "pageCount": 1, "pageNo": 1, "total": 1 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =|| || from ||用户自定义的手机型号|| 说明:如果用户在客户端上使用,优先显示用户自定义机型,如果没有自定义机型,则显示真实机型。如果在其他平台评论的,例如网页版,WAP等,按照原来的显示规则。 === 1.4 论坛发贴、回帖接口增加机型字段=== 接口: 发帖:http://mrobot.pconline.com.cn/proxy/itbbs/forums [[BR]] 回帖:http://mrobot.pconline.com.cn/proxy/itbbs/topics [[BR]] 发帖:http://mrobot.pconline.com.cn/proxy/piebbs/forums [[BR]] 回帖:http://mrobot.pconline.com.cn/proxy/piebbs/topics [[BR]] **说明** > 原论坛发帖、回帖接口增加传入用户机型字段和用户自定义机型字段 [[BR]] **缓存时间** >无 **提交方式** >POST **是否登录** > 是 **新增参数** ||= 参数名 =||= 类型 =||= 默认值 =||= 是否必需 =||=说明=|| || model ||string|| || 是 ||用户实际的手机型号|| || custom ||string|| || 是 ||用户自定义的手机型号|| === 1.5 帖子终端页增加机型显示=== 接口: http://mrobot.pconline.com.cn/v2/itbbs/topics/ {postId} [[BR]] http://mrobot.pconline.com.cn/v2/piebbs/topics/ {postId} [[BR]] 示例:http://mrobot.pconline.com.cn/v2/itbbs/topics/52713495?pageNo=1&picRule=2&authorId=0&topicTemplate=3.6.0&app=pconlinebrowser&appVersion=4.5.0&size=18 **说明** > 帖子终端页接口返回用户自定义机型 [[BR]] **缓存时间** >无 **提交方式** >GET **是否登录** > 否 === 1.6 手机号注册=== 接口:http://passport3.pconline.com.cn/passport3/api/registerForMobile.jsp [[BR]] **说明** > 手机注册接口 [[BR]] **缓存时间** >无 **提交方式** >HTTPS POST **是否登录** > 否 **参数** ||= 参数名 =||= 是否必需 =||= 默认值 =||=说明=|| || mobile || 是 || ||手机号码|| || mobileVCode || 是 || ||手机验证码|| || username || 是 || ||用户名,参数值等于mobile || || password || 是 || ||登录密码|| || passwordConfirm || 是 || ||确认密码|| || noAccountName || 是 || 1 ||参数=1,系统自动为账号生成用户名|| || req_enc || 否 ||utf-8 ||提交编码|| || resp_enc || 否 ||utf-8 ||返回编码|| **返回** {{{#!java {"status":0,"desc":"OK","accountId":" + accountId + "} {"status":1,"desc":"用户名是必填项","field":"username"} {"status":2,"desc":"用户名不允许包含空白字符","field":"username"} {"status":3,"desc":"用户名不允许为纯数字","field":"username"} {"status":4,"desc":"该用户名前缀不能使用","field":"username"} {"status":5,"desc":"该用户名涉及关键字不能使用","field":"username"} {"status":6,"desc":"用户名过长,请输入8个汉字或16个字符(数字,字母,减号,下划线,点号,中文,日文平假名/片假名)","field":"username"} {"status":7,"desc":"用户名含有非法字符,用户名只支持数字、字母、减号、下划线、点号、中文、日文平假名/片假名","field":"username"} {"status":8,"desc":"该用户名已经注册使用","field":"username"} {"status":21,"desc":"密码是必填项","field":"password"} {"status":22,"desc":"密码过短,密码为6-16个字母、数字、符号的组合","field":"password"} {"status":23,"desc":"密码过长,不超过16个字符","field":"password"} {"status":24,"desc":"密码只能是字母、数字、英文符号的组合","field":"password"} {"status":25,"desc":"确认密码密码是必填项","field":"password"} {"status":26,"desc":"两次输入的密码不一致,请确认","field":"password"} {"status":41,"desc":"手机号必须输入","field":"mobile"} {"status":42,"desc":"请输入正确的手机号码","field":"mobile"} {"status":43,"desc":"请输入验证码","field":"mobileVCode"} {"status":44,"desc":"请输入正确验证码","field":"mobileVCode"} {"status":45,"desc":"验证码错误或失效","field":"mobileVCode"} {"status":46,"desc":"该手机号码已经注册","field":"mobile"} {"status":-1,"desc":"非法请求"} {"status":-3,"desc":"注册失败,请稍候再试!"} {"status":-4,"desc":"其他错误:"......"} }}} **返回参数说明** ||= 参数名 =||= 参数含义 =|| || status ||处理状态(0 为成功,其他为失败)|| || desc ||处理状态描述|| || accountId ||用户ID|| || field ||定位到表单输入框(状态为失败时才出现)|| === 1.7 注册时发送手机验证码=== 接口:http://passport3.pconline.com.cn/passport3/api/sendVerificationCode.jsp [[BR]] **说明** > 用于注册新账号时发送手机验证码,同一个手机号码一天之内只能发5次(目前的设定) [[BR]] **缓存时间** >无 **提交方式** >POST **是否登录** > 否 **参数** ||= 参数名 =||= 是否必需 =||= 默认值 =||=说明=|| || act || 是 || ||act = getPassword 不检查手机号码是否已经注册 || || ~~act~~ || ~~是~~ || ||~~act = check: 必须传 verificationCode = (验证码),检查验证码是否正确 ~~|| || ~~act~~ || ~~是~~ || ||~~act = 不传 不传act参数,将会默认检查手机是否注册,已注册手机不发验证码 ~~|| || mobile || 是 || ||手机号|| || vCodeKey || 是 || ||sendVerificationCode.jsp+当前系统毫秒数 进行md5加密|| || VCodeTime || 是 || ||为系统当前时间毫秒数|| || req_enc || 否 ||utf-8 ||提交编码|| || resp_enc || 否 ||utf-8 ||返回编码|| **返回** {{{#!java {"code":0, "message":"发送验证码成功,手机号:1111111"} {"code":-1, "message":"...各种情况.."} }}} **返回参数说明** ||= 参数名 =||= 参数含义 =|| || status ||处理状态(0 为成功,其他为失败)|| || desc ||处理状态描述|| === 1.8 验证手机号是否可用=== 接口:http://passport3.pconline.com.cn/passport3/api/validate_mobile.jsp [[BR]] **说明** > 验证手机号是否可用 [[BR]] **缓存时间** >无 **提交方式** >GET **是否登录** > 否 **参数** ||= 参数名 =||= 是否必需 =||= 默认值 =||=说明=|| || mobile || 是 || ||手机号|| || req_enc || 否 ||utf-8 ||提交编码|| || resp_enc || 否 ||utf-8 ||返回编码|| **返回** {{{#!java {"status":0,"desc":"OK"}' {"status":41,"desc":"手机号必须输入","field":"mobile"} {"status":42,"desc":"请输入正确的手机号码","field":"mobile"} {"status":43,"desc":"该手机号码已经注册","field":"mobile"} }}} **返回参数说明** ||= 参数名 =||= 参数含义 =|| || status ||处理状态(0 为成功,其他为失败)|| || desc ||处理状态描述|| === 1.9 意见反馈增加上传图片=== 接口: [[BR]] **说明** > [[BR]] **缓存时间** > **提交方式** > **是否登录** > **参数** **返回** **返回参数说明** ||= 参数名 =||= 参数含义 =||