Skip to content

获取帖子[详情]

  • 接口地址:/api/fresns/v1/post/{pid}/detail
  • 请求方式:GET
  • 传参方式:Rest + Query

Headers 可选参数

参数名公开模式(是否必传)私有模式(是否必传)
X-Fresns-AidNOYES
X-Fresns-Aid-TokenNOYES
X-Fresns-UidNOYES
X-Fresns-Uid-TokenNOYES

Path 变量

变量名类型是否必传说明
pidStringYES帖子 ID

Query 参数

参数名类型是否必传说明
mapIdNumberNO地图服务商编号
mapLngStringNO地图经度(用于计算距离)
mapLatStringNO地图纬度(用于计算距离)
filterTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
filterKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterGroupTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 group 参数有效
filterGroupKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterHashtagTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 hashtags 参数有效
filterHashtagKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterGeotagTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 geotag 参数有效
filterGeotagKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterAuthorTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 author 参数有效
filterAuthorKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterQuotedPostTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 quotedPost 参数有效
filterQuotedPostKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterPreviewLikeUserTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 previewLikeUsers 参数有效
filterPreviewLikeUserKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterPreviewCommentTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 previewComments 参数有效
filterPreviewCommentKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组

接口使用说明

  • 如果是私有模式,当过期后 users->expired_at,需判断到期后的状态。
    • 配置表 site_private_end_after 键值为 1 时,该接口不可请求;
    • 键值为 2 时,再判断发表时间,如果 posts->created_at 发表时间大于失效时间 users->expired_at,则不输出;如果发表时间小于失效时间,则代表为失效前的内容,可以输出。

返回结果

json
{
    "code": 0,
    "message": "ok",
    "data": {
        "items": {
            "title": "String / SEO 标题",
            "keywords": "String / SEO 关键词",
            "description": "String / SEO 描述"
        },
        "detail": {
            // 通用数据结构->帖子信息
        }
    }
}

Released under the Apache-2.0 License