Feed: categories

Feed: categories

首页数据,统计每个分类下(或未分类)的数据,类型有”node”, “publication”, “demand”, “xfile”.

Request

HTTP request

GET https://www.featapi.com/api/feed/categories/

Parameters

  • Query parameters
Parameter nameValueDescription
Optional parameters
typestring类型有:”node”, “publication”, “demand”, “xfile”,如:/api/feed/categories/?type=node,publication
within_distancestring手机端用来筛选指定距离内的对象,仅支持type=demand;距离(km),默认为5km
lngstring手机端用来筛选指定距离内的对象,仅支持type=demand;提交用户地理位置坐标
latstring手机端用来筛选指定距离内的对象,仅支持type=demand;提交用户地理位置坐标

授权

此请求需要具有以下所有范围的授权:

Scopes

有关更多信息,请参阅认证和授权页面。

Request body

Response

如果成功,则此方法在响应正文中返回 Dimzou.category 资源或未分类资源。

每个资源附带一个额外的meta field:

feed_created_atdatetime or null本资源里的数据项的最新原始创建时间(资源以此排序)
feed_updated_atdatetime or null本资源里的数据项最新更新时间
feeds_countint or null本资源里的数据项数

注意meta里面只统计当前级别的数据。

200  返回分类成功

{
    "data": [
        {
            "id": "uncategory",
            "meta": {
                "feed_updated_at": "2020-07-13T01:44:31.606714Z",
                "feed_created_at": "2020-07-13T01:44:31.606714Z",
                "feeds_count": 5 
            } 
        },
        {
            "id": 2,
            "name": "Popular Science",
            "parent_id": 1,
            "parent": {
                "id": 1,
                "name": "Joy",
                "parent_id": null,
                "kind": "category",
                "slug": "joy",
                "meta": {
                    "feed_updated_at": null,
                    "feed_created_at": null,
                    "feeds_count": null 
                } 
            },
            "kind": "category",
            "slug": "popular-science",
            "level": 2,
            "children": [
                {
                    "id": 4,
                    "name": "History & Culture",
                    "parent_id": 2,
                    "kind": "category",
                    "slug": "history-culture",
                    "meta": {
                        "feeds_count": 5,
                        "feed_updated_at": "2020-07-13T01:44:31.606714Z",
                        "feed_created_at": "2020-07-13T01:42:30.304412Z"  
                    } 
                } ],
            "meta": {
                "feed_updated_at": null,
                "feed_created_at": null,
                "feeds_count": null 
            } 
        } ] 
}

404 Not found

示例返回数据可参考 API Common – Resource Not Found

发表评论

您的电子邮箱地址不会被公开。

您可以使用以下 HTML标签和属性:

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

Captcha Code