获取栏目列表

基本信息

接口名称： 获取栏目列表

接口类型： 数据获取

接口说明： 获取站点的栏目列表

详细信息

URL

https://www.baklib.com/api/v1/channels

完整URL示例

https://www.baklib.com/api/v1/channels?tenant_id=682c1cf8-41bf-4417-aa05-3e682fb5174b&_page=1&_per_page=10

HTTP请求方式

GET

授权认证方式

默认方式，需要添加请求header

Authorization: Bearer <token>

请求参数

参数	必选	类型及范围	说明
tenant_id	true	Integer	站点id
parent_id	false	Integer	父级栏目id
_page	false	Integer	需要显示的页码, 默认1
_per_page	false	Integer	每页显示数量, 默认10, 最大不能超过50

示例代码

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",
  _page: 1,
  _per_page: 2
}
response = client.get("/api/v1/channels", params)
JSON.parse(response.body)

返回结果

{
  "code": 0,
  "status": "success",
  "message": {
    "meta": {
      "current_page": 1,
      "total_pages": 1,
      "total_count": 1
    },
    "items": [
      {
        "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

Overview - 总览

站点