wiki:intf

Version 12 (modified by guhenghong, 10 years ago) (diff)

--

接口索引

    1. 1. 论坛接口
      1. 1.1 发帖入口
        1. 1.1.1 论坛pc/wap发帖接口
        2. 1.1.2 seo/发帖机 发帖接口
        3. 1.1.3 poster.jsp发帖接口
        4. 1.1.4 车友圈app发帖接口
        5. 1.1.5 车友圈app旧发帖接口
        6. 1.1.6 车友会pc/wap发帖接口
        7. 1.1.7 forums.jsp接口
      2. 1.2 获取帖子详情接口
        1. 1.2.1 根据tids获取帖子列表详情接口
      3. 1.3 提供给app的接口
        1. 1.3.1 车友会app帖子详情接口

1. 论坛接口

备注：

开发环境URL前缀： http://dev39.pcauto.com.cn/

测试环境URL前缀： http://v71.pcauto.com.cn/

线上环境URL前缀： http://bbs.pcauto.com.cn/

1.1 发帖入口

1.1.1 论坛pc/wap发帖接口

接口/action/topic/create.ajax  [POST]
说明 : 论坛pc/wap发帖接口
请求参数 ：
  	type:帖子类型
	*title:标题
	*message:内容
	mirrorFid:
	category:帖子类别
	qType：提问帖分类
	qSubtype：提问帖分类
	askTo:向谁提问
	agent:帖子来源
	rewardAmount：
	sendMsg：是否发消息
	uploadId：


是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果：
{"status":0, "tid":342343}

1.1.2 seo/发帖机 发帖接口

接口/util/reposter.ajax   [POST]
说明 : seo/发帖机 发帖接口
请求参数 ：
  //发帖
	*uid:发帖用户id
	*title:标题
	*content:内容
	fid:板块id
	sgId:车系id
	askTo:向谁提问
	type:帖子类型
	createAt:发帖时间
	sourceType:seo的数据源

	//回帖
	*method:reply回复
	*uid:回复用户id
	*tid:帖子id
	content:回复内容
	createAt:发帖时间


是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果：
{"status":0, desc:"", "tid":342343, pid:13423}

1.1.3 poster.jsp发帖接口

接口/util/poster.jsp [POST]
说明 : seo/发帖机 发帖接口
请求参数 ：
	//发帖参数
	*uid：用户id  
	*content: 内容
	*title:	标题
	callback: 回调函数
	topicType: 帖子类型默认普通帖
	type:帖子类别（原创、讨论..）
	createAt:创建时间
	fid:板块id
	sgId:车系id
	
	//回帖
	*method:reply回复
	*uid：用户id 
	*tid:主题帖id
	*content: 内容
	
	//更新
	*method:update更新
	*uid：用户id 
	*tid:主题帖id
	type:帖子类型
	*title:标题
	*content: 内容


是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果：
{status:0,desc:"成功",topicId:234123413,postId:4254354}

1.1.4 车友圈app发帖接口

接口/appapi/1/topic/create.ajax  [POST] 
说明 : 车友圈app发帖接口
请求参数 ：
	type:帖子类型默认空位普通贴
	appTitle:标题
	category:帖子类别(默认"原创")
	*message:正文内容
	messageImage：图片+图片描述
	*agent:发帖来源
	sendMsg：是否接收消息
	qType:提问帖分类
	qSubtype：提问帖分类


是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果：
{"Location":"http://dev39.pcauto.com.cn/topic-8760145.html","code":0,"message":"发帖成功","version":"v1.0(latest)"}

1.1.5 车友圈app旧发帖接口

接口/appapi/1/forum/createTopic.ajax  [POST] 
说明 : 车友圈app发帖接口
请求参数 ：
	type:帖子类型默认空位普通贴
	appTitle:标题
	category:帖子类别(默认"原创")
	*message:正文内容
	messageImage：图片+图片描述
	*agent:发帖来源
	sendMsg：是否接收消息
	qType:提问帖分类
	qSubtype：提问帖分类


是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果：
{"desc":"{\"tid\":8760144}","status":0}

1.1.6 车友会pc/wap发帖接口

接口/intf/topic/create.ajax  [POST]
说明 : seo/发帖机 发帖接口
请求参数 ：
	type:帖子类型默认空位普通贴
	appTitle:标题
	category:帖子类别(默认"原创")
	*message:正文内容
	messageImage：图片+图片描述
	*agent:发帖来源
	sendMsg：是否接收消息
	qType:提问帖分类
	qSubtype：提问帖分类


是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果：
{"status":0, desc:"", "tid":342343, pid:13423}

1.1.7 forums.jsp接口

接口/rest/forums.jsp    [POST]
说明 : 一般不建议用
请求参数 ：
	*title:标题
	*message:内容
	topicType:帖子类型
	agent:发帖来源
	type:帖子类别
	sendMsg:是否接收消息
	qType:提问分类
	qSubtype：提问分类
	uploadId：


是否登录 : 否
缓存时间 : 无
是否分页 : 否


返回结果：
{Location\":\"\"}

1.2 获取帖子详情接口

1.2.1 根据tids获取帖子列表详情接口

接口/appapi/1/topic/getTopics  [GET]
说明 : 论坛pc/wap发帖接口
请求参数 ：
  	*tids：帖子ids以","分隔
	callback:

是否登录 : 否
缓存时间 : 缓存6小时
是否分页 : 否


返回结果：
[
    {
        "content": "近期有人吗？",
        "createAt": 1436580106000,
        "dynaType": 1,
        "fid": 14674,
        "forumName": "嘉年华论坛",
        "isPick": false,
        "isRecommend": false,
        "lastPostAt": 1458014310000,
        "nickName": "江门江门去哪儿",
        "replyCount": 16,
        "tid": 7938878,
        "title": "江门市大概搞好几钱呢？",
        "uid": 40869922,
        "uri": "http://bbs.pcauto.com.cn/topic-7938878.html",
        "userName": "江门江门去哪儿",
        "view": 131
    }
]

1.3 提供给app的接口

备注：ios/android直掉接口

android:

/rest/topics/

/action/user/favorite.jsp

/action/user/favorite_delete.jsp

/action/user/check_favorite.jsp

/appapi/1/post/bestAnswer.do

/intf/hotForums.do

/intf/common/_block_forums_app.jsp

/plugins/autoclub/user/topics.do?resp_enc=utf-8&req_enc=utf-8&source_agent=1

/plugin/vip/toApply.do

/appapi/1/topic/create.ajax?

/appapi/1/forum/getImagesByTid.do

ios:

/action/user/favorite.jsp

/action/user/favorite_delete.jsp

/action/user/check_favorite.jsp

/rest/forums

/rest/topics

/batchFavForums.ajax

/appapi/1/forum/getImagesByTid.do

/appapi/1/post/bestAnswer.do

/appapi/1/topic/create.ajax

/club/duihuan

1.3.1 车友会app帖子详情接口

接口/appapi/1/forum/topic  [GET]
说明 : 论坛pc/wap发帖接口
请求参数 ：
  	*topicId： 帖子id
        pageNo： 页码
        pageSize: 页大小
        desc：  按楼层排序(顺序/降序)
        authorId：查看某人再该贴的回复


是否登录 : 
缓存时间 : 缓存6小时
是否分页 : 否


返回结果：
 "code": 0,
    "message": "操作成功",
    "pageCount": 1,
    "pageNo": 1,
    "pageSize": 19,
    "postList": [
        {
            "agent": 0,
            "author": {
                "isExpert": false,
                "isVip": false,
                "level": "太平洋舰队新兵",
                "name": "我为傻猪代言",
                "nickname": "我为傻猪代言",
                "userId": 41373379,
                "validBrandIcon": ""
            },
            "createAt": 1440578296000,
            "floor": 1,
            "forGrade": 1,
            "gradeAmount": 0,
            "gradeCount": 0,
            "message": "就想问下这车性价比怎么样？油耗怎么样？？",
            "postId": 81490058,
            "status": 0
        }
    ]
    "topic": {
        "author": {
            "level": "太平洋舰队新兵",
            "name": "我为傻猪代言",
            "nickname": "我为傻猪代言",
            "userId": 41373379
        },
        "bbsId": 19,
        "createAt": 1440578296000,
        "forumId": 14674,
        "forumName": "嘉年华论坛",
        "isContainImage": false,
        "isLock": false,
        "isPick": false,
        "isRecommend": false,
        "lastPostAt": 1458699802000,
        "replyCount": 9,
        "rights": {
            "allowDeleteTopic": true,
            "allowSettingPick": true
        },
        "title": "就想问下这车性价比怎么样？油耗怎么样？？",
        "type": "question",
        "uri": "http://v71.pcauto.com.cn/topic-8268007.html",
        "view": 3
    },
    "total": 10,
    "version": "v1.0(latest)"
}