基本信息
接口名称: 获取栏目详细信息
接口类型: 数据获取
接口说明: 获取某个栏目的详细信息
详细信息
URL
https://www.baklib.com/api/v1/channels/:id
完整URL示例
https://www.baklib.com/api/v1/articles/24fc71a6-a939-45a8-9fa3-65e57e3d10d0
HTTP请求方式
GET
授权认证方式
默认方式,需要添加请求header
Authorization: Bearer <token>
请求参数
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
id | true | String | 栏目id |
tenant_id | true | Integer | 站点id |
示例代码
require 'faraday'
require 'json'
host = 'https://www.baklib.com/'
client = Faraday.new(url: host) do |conn|
conn.headers['Authorization'] = "Bearer #{token}"
conn.headers['Content-Type'] = 'application/json'
conn.adapter :net_http
end
params = {
tenant_id: "682c1cf8-41bf-4417-aa05-3e682fb5174b",
}
response = client.get("/api/v1/channels", params)
JSON.parse(response.body)
返回结果
{
"code": 0,
"status": "success",
"message": {
"id": "778a8f61-4cc1-4a97-a8fd-4a7bab3919f5",
"parent_id": "24fc71a6-a939-45a8-9fa3-65e57e3d10d0",
"name": "ruby",
"identifier": "a220",
"description": null,
"content": {},
"ordinal": 0,
"features": {
"icon_name": "fa fa-folder-o",
"article_template": "article.default"
},
"status": 1,
"status_name": "发布",
"kind": 1,
"kind_name": "栏目",
"slug": "0f77/a220",
"tenant_id": "682c1cf8-41bf-4417-aa05-3e682fb5174b",
"visits_count": 0,
"created_at": "2020-04-01T11:56:15.117+08:00",
"updated_at": "2020-04-01T11:56:15.117+08:00",
"created_by": "5b062111-13d7-41a2-9d2b-f3e0de23c98c",
"updated_by": "5b062111-13d7-41a2-9d2b-f3e0de23c98c",
"tag_list": []
}
}
返回字段说明
返回值字段 | 字段类型 | 说明 |
---|---|---|
code | Integer | 状态码 |
status | String | 返回状态 |
current_page | Integer | 当前页数 |
total_pages | Integer | 总页数 |
total_count | Integer | 总数量 |
id | String | 栏目id |
parent_id | String | 父级栏目id |
name | String | 栏目名称 |
identifier | String | 栏目唯一标识符 |
status | Integer | 栏目状态 |
status_name | String | 栏目状态中文名称 |
tenant_id | String | 站点id |
created_at | Datetime | 创建时间 |
updated_at | Datetime | 更新时间 |
created_by | String | 创建者id |
updated_by | String | 更新者id |