Skip to content
On this page

Post Detail

  • Endpoint Path: /api/v2/post/{pid}/detail
  • Method: GET
  • Request: Rest + Query

Headers Optional Parameter

Parameter NamePublic Mode (Required)Private Mode (Required)
X-Fresns-Aidoptionalrequired
X-Fresns-Aid-Tokenoptionalrequired
X-Fresns-Uidoptionalrequired
X-Fresns-Uid-Tokenoptionalrequired

Rest Params

Parameter NameTypeRequiredDescription
pidStringrequired帖子 PID

Query Params

Parameter NameTypeRequiredDescription
mapIdNumberoptional地图服务商编号
mapLngStringoptional地图经度(用于计算距离)
mapLatStringoptional地图纬度(用于计算距离)
whitelistKeysStringoptional白名单键名,只返回给定键名的键值对
多个以英文逗号隔开,支持「点表示法」表示多维数组
blacklistKeysStringoptional黑名单键名,从返回数据中删除指定的键值对
多个以英文逗号隔开,支持「点表示法」表示多维数组

Request Description

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

Return

json
{
    "code": 0,
    "message": "ok",
    "data": {
        "items": {
            "title": "String / SEO 标题",
            "keywords": "String / SEO 关键词",
            "description": "String / SEO 描述"
        },
        "detail": {
            // Common Data Structure -> Post Info
        }
    }
}

Released under the Apache-2.0 License