pconline_4.5.0/interface: 评论机型接口文档.txt

File 评论机型接口文档.txt, 7.1 KB (added by chenziyang, 10 years ago)
Line 
11、评论创建接口：
2        http://v14.pconline.com.cn:9092/action/comment/create.jsp
3参数：
4{
5        id：评论主题id
6        url：要发表评论的文章链接地址(通过id或者url[优先id]定位主题，若不存在且url参数不为空则新建)
7        content：评论内容（必选参数）
8        title：要发表评论的文章标题（可选参数）
9        replyFloor2：回复楼层数（可选参数）
10        columnId：栏目id（可选参数）
11        anonymous：匿名,1为匿名（可选参数）
12        needCaptcha：需要验证码（可选参数）
13        captcha：验证码(needCaptcha为1时为必选参数,性能测试可以不要)
14        isEncode：是否通过utf8转码（可选参数）
15        encodeHtml：是否对评论内容HTML标签转码（可选参数，默认0为不需要）
16        client: 评论来源（可选参数 1:PC 2:Android 3:Iphone 4:新浪 5:QQ 6:Wap版 7:微信，默认为1）
17        partId: 分段落评论段落Id（可选参数，汽车网直播使用，默认为0）
18        model：移动端的手机型号（可选参数，目前电脑网使用）
19        customModel：移动端的自定义手机型号（可选参数，目前电脑网使用）
20        picUrl：评论图片时的url（可选参数，目前电脑网使用）
21        atAuthor：是否@小编（可选参数，默认为0为不@小编，目前电脑网使用）
22        windowname：跨域用（可选参数，1为跨域，默认为0）
23        callback：回调函数（可选参数）
24}
25返回: json或script格式(windowname=1时)数据
26        {
27                "commentId":评论id,
28                "floor":楼层,
29                "showName":用户名称,
30                "brief":评论内容,
31                "status":评论状态(一般是0,表示待审),
32                "createTime":发表时间,
33                "resultCode":评论是否成功，1或0表示成功，1代表先出后审，0代表先审后出。负数时,表示失败,失败原因，见resultMsg,
34                "resultMsg":提示信息,
35    "userId":用户id，未登录则为-1，
36                "topicId":评论主题id,
37                "ip":ip,
38                "model":手机型号,
39                "customModel":自定义手机型号,
40                "picUrl":评论图片时的url
41        }
42       
432、http://v14.pconline.com.cn:9092/action/comment/create_utf8.jsp
44参数：
45{       
46        id：评论主题id
47        url：要发表评论的文章链接地址(通过id或者url[优先id]定位主题，若不存在且url参数不为空则新建)
48        content：评论内容（必选参数）
49        title：要发表评论的文章标题（可选参数）
50        replyFloor2：回复楼层数（可选参数）
51        columnId：栏目id（可选参数）
52        anonymous：匿名,1为匿名（可选参数）
53        needCaptcha：需要验证码（可选参数）
54        captcha：验证码(needCaptcha为1时为必选参数,性能测试可以不要)
55        isEncode：是否通过utf8转码（可选参数）
56        encodeHtml：是否对评论内容HTML标签转码（可选参数，默认0为不需要）
57        client: 评论来源（可选参数 1:PC 2:Android 3:Iphone 4:新浪 5:QQ 6:Wap版 7:微信，默认为1）
58        model：移动端的手机型号（可选参数，目前电脑网使用）
59        customModel：移动端的自定义手机型号（可选参数，目前电脑网使用）
60        picUrl：评论图片时的url（可选参数，目前电脑网使用）
61        atAuthor：是否@小编（可选参数，默认为0为不@小编，目前电脑网使用）
62        windowname：跨域用（可选参数，1为跨域，默认为0）
63}
64返回: json或script格式(windowname=1时)数据
65        {
66                "commentId":评论id,
67                "floor":楼层,
68                "showName":用户名称,
69                "brief":评论内容,
70                "status":评论状态(一般是0,表示待审),
71                "createTime":发表时间,
72                "resultCode":评论是否成功，1或0表示成功，1代表先出后审，0代表先审后出。负数时,表示失败,失败原因，见resultMsg,
73                "resultMsg":提示信息,
74                "userId":用户id，未登录则为-1,
75                "model":手机型号,
76                "customModel":自定义手机型号,
77                "picUrl":评论图片时的url
78        }
79       
803、http://v14.pconline.com.cn:9092/action/comment/list_json.jsp
81        如：http://v14.pconline.com.cn:9092/action/comment/list_json.jsp?callback=test&url=http://mobile.pconline.com.cn/737/7373900.html
82        参数：{   
83                url:文章主题url
84                tId:文章主题id
85                pageSize:每页大小
86                pageNo:第几页
87                arch:是否归档
88                callback:回调函数
89                noUbb:是否使用ubb
90                reverse:升降序,按楼层排序，0降序，1升序
91        }
92       
93        返回失败
94        {error:'param error'}
95        {"error","topic not found"}
96       
97        返回成功：
98        {
99                "total":评论总条数,
100                "pageNo":页码,
101                "pageCount":多少页,
102                "pageSize":每页多少条,
103                "title":文章标题,
104                "topicId":评论主题,
105                "data":[
106                        评论数据集
107                        {
108                                "id": 评论id,"nickName":昵称,"createTime":创建时间,"ip":ip,"floor":楼层,"content":评论内容,"model":手机型号,"customModel":自定义手机型号,"picUrl":图片url,
109                                "tags"://依次是 安卓党、果粉、学霸军、黑客、喷子、大湿、水军、其他，预留用
110                                        [{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false}]
111                        }
112                        ...
113                ]
114        }
115
1164、http://v14.pconline.com.cn:9092/action/comment/list_new_json.jsp (包含回复的，参数同list_json.jsp)
117如：http://v14.pconline.com.cn:9092/action/comment/list_new_json.jsp?callback=test&url=http://mobile.pconline.com.cn/737/7373900.html
118{
119        "total":评论总条数,
120        "pageNo":页码,
121        "pageCount":多少页,
122        "pageSize":每页多少条,
123        "title":文章标题,
124        "topicId":评论主题,
125        "data":[
126                评论数据集
127                {
128                        "id": 评论id,"nickName":昵称,"createTime":创建时间,"ip":ip,"floor":楼层,"content":评论内容,"face":图像,"status":评论状态,"model":手机型号,"customModel":自定义手机型号,"picUrl":图片url,
129                        "tags": //依次是 安卓党、果粉、学霸军、黑客、喷子、大湿、水军、其他，预留用
130                                [{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false}],
131                        "replyRef":{
132                                "id": 评论id,"nickName":昵称 .... "status":评论状态,"model":手机型号,"picUrl":图片url,
133                                "tags":[{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false},{"num":0,"isLight":false}],
134                        },
135                       
136                }
137                ...
138        ]
139}
140
1415、http://v14.pconline.com.cn:9092/intf/tophot.jsp
142http://v14.pconline.com.cn:9092/intf/tophot.jsp?url=http://mobile.pconline.com.cn/737/7373900.html
143参数：{   
144        url:文章主题url
145        tId:文章主题id
146        size:数量大小 ，默认5
147        callback:回调函数 （可选参数）
148        noUbb:是否使用ubb （可选参数）
149        encodeHtml：是否对评论内容HTML标签转码（可选参数，默认0为不需要）
150}
151{
152        "title":文章标题,
153        "topicId":评论主题,
154        "url":文章url,
155        "data":[
156                评论数据集
157                {"id": 评论id,"nickName":昵称,"createTime":创建时间,"ip":ip,"floor":楼层,"model":手机型号,"customModel":自定义手机型号,"picUrl":图片url"content":评论内容,"support":支持数},
158                ...
159        ]
160}