获取帖子[详情]
- 接口地址:
/api/fresns/v1/post/{pid}/detail - 请求方式:
GET - 传参方式:
Rest+Query
Headers 可选参数
| 参数名 | 公开模式(是否必传) | 私有模式(是否必传) |
|---|---|---|
| X-Fresns-Aid | NO | YES |
| X-Fresns-Aid-Token | NO | YES |
| X-Fresns-Uid | NO | YES |
| X-Fresns-Uid-Token | NO | YES |
Path 变量
| 变量名 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
| pid | String | YES | 帖子 ID |
Query 参数
| 参数名 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
| mapId | Number | NO | 地图服务商编号 |
| mapLng | String | NO | 地图经度(用于计算距离) |
| mapLat | String | NO | 地图纬度(用于计算距离) |
| filterType | String | NO | whitelist 只返回给定键名的键值对blacklist 从返回数据中删除指定的键值对 |
| filterKeys | String | NO | 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
| filterGroupType | String | NO | whitelist 只返回给定键名的键值对blacklist 从返回数据中删除指定的键值对仅对返回结果中 group 参数有效 |
| filterGroupKeys | String | NO | 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
| filterHashtagType | String | NO | whitelist 只返回给定键名的键值对blacklist 从返回数据中删除指定的键值对仅对返回结果中 hashtags 参数有效 |
| filterHashtagKeys | String | NO | 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
| filterGeotagType | String | NO | whitelist 只返回给定键名的键值对blacklist 从返回数据中删除指定的键值对仅对返回结果中 geotag 参数有效 |
| filterGeotagKeys | String | NO | 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
| filterAuthorType | String | NO | whitelist 只返回给定键名的键值对blacklist 从返回数据中删除指定的键值对仅对返回结果中 author 参数有效 |
| filterAuthorKeys | String | NO | 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
| filterQuotedPostType | String | NO | whitelist 只返回给定键名的键值对blacklist 从返回数据中删除指定的键值对仅对返回结果中 quotedPost 参数有效 |
| filterQuotedPostKeys | String | NO | 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
| filterPreviewLikeUserType | String | NO | whitelist 只返回给定键名的键值对blacklist 从返回数据中删除指定的键值对仅对返回结果中 previewLikeUsers 参数有效 |
| filterPreviewLikeUserKeys | String | NO | 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
| filterPreviewCommentType | String | NO | whitelist 只返回给定键名的键值对blacklist 从返回数据中删除指定的键值对仅对返回结果中 previewComments 参数有效 |
| filterPreviewCommentKeys | String | NO | 多个以英文逗号隔开,支持「点表示法」表示多维数组 |
接口使用说明
- 如果是私有模式,当过期后
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": {
// 通用数据结构->帖子信息
}
}
}