Bbs/getitem

出自天涯开放平台资源

跳转到: 导航, 搜索

目录

bbs/getitem

获取板块信息

URL

http://open.tianya.cn/api/bbs/getitem.php

支持格式

XML/JSON

HTTP请求方式

GET/POST

是否需要登录

true,关于授权机制,参见OAuth相关说明

请求数限制

true,关于请求数限制,参见OAuth相关说明

请求参数

  必选 类型及范围 说明
appkey true string 申请应用时分配的appkey,调用接口时候代表应用的唯一身份
oauth_token true string 授权成功后所获得的 oauth_token
oauth_token_secret true string 授权成功后所获得的oauth_token_secret
timestamp true string 请求时候产生的时间戳time()
tempkey true string strtoupper(md5($timestamp.$appkey.$oauth_token.$oauth_token_secret.$appsecret))
item true string 版块id
outformat false string json或xml

注意事项

http://open.tianya.cn/api/bbs/getitem.php 若取当前用信息错误,则返回400错误,提示:"error_code"=>"40002", "error_msg"=>"request data error若取当前用信息错误,则返回400错误,提示: "error_code"=>"40002", "error_msg"=>"request data error"

返回结果

XML示例

<?xml version="1.0" encoding="utf8"?><rows><item id="0"><id>free</id><name>天涯杂谈</name><type>主版</type></item></rows>

JSON示例

{"rows":[{"id":"free","name":"天涯杂谈","type":"主版"}]}

返回示例说明

正常返回 名称 类型 输出条件 说明
id int 版块ID
name String 版块名
type String 主版、副版、城市
category String 类别[文学、娱乐等]
describe String bMore=true 版块描述
sub_item String bMore=true 子栏目,“/”分隔开
article_count int bMore=true 版块帖子总数
reply_count int bMore=true 版块回复总数
click_count int bMore=true 版块点击总数
create_time int bMore=true 版块创建时间
content_limit_len int bMore=true 版块限制发表最小字数[<=0表示不限制]

PHP示例


SDK下载
代码示例如下: 
include 'tyapi.php'; 
//参数设置 
$appkey=; 
$appsecret=;
$param['item'] = ‘free’;
$url = 'http://open.tianya.cn/api/bbs/getitem.php';
$data = do_post($url,$appkey,$appsecret,$_SESSION["oauth_token"],$_SESSION["oauth_token_secret"],$param);
查看
个人工具
成功案例
帮助中心