获取帖子

GET/v1/posts/{id}

返回帖子及其正文、投票、图片和所属社区。

请求

Shell

curl -g "https://api.nogitsu.com/v1/posts/{id}"

参数

id
路径必填
条目的 ID，为 UUID。
文本
reveal
查询可选
设为 1 时包含被标记为剧透的帖子正文。
文本
允许的值1

响应

请求成功时返回 200 和以下 JSON：

id文本 (uuid)
slug文本
community对象
- id文本 (uuid)
- slug文本
- language文本
- kind文本
  允许的值workboarduser
- name文本
- iconUrl文本 (uri)可为 null
- theme文本
  允许的值violetblueskycyanemeraldgreenyellowamberrosepink
- isSampletrue 或 false
author对象可为 null
- username文本
- displayName文本
- avatarUrl文本 (uri)可为 null
authorFlair文本可为 null
kind文本
允许的值textlinkimagepoll
title文本可为 null
excerpt文本可为 null
flair对象可为 null
- id文本 (uuid)
- label文本
- tone文本
  允许的值neutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
spoiler对象可为 null
- workTitle文本可为 null
- unitNumber数字可为 null
  至少 0
work对象可为 null
- id文本 (uuid)
- title文本
- medium文本
  允许的值animedonghuaanimationmangamanhwamanhuawebtoon
- slug文本
- unitNumber数字可为 null
  至少 0
isAdulttrue 或 false
isPinnedtrue 或 false
isLockedtrue 或 false
score整数可为 null
-9007199254740991 到 9007199254740991
commentCount整数
0 到 9007199254740991
reactions对象列表
- kind文本
  允许的值lovelaughwowsadclapfirethinkangrypartycry
- count整数
  0 到 9007199254740991
link对象可为 null
- url文本 (uri)
- host文本
- title文本可为 null
- description文本可为 null
- image对象可为 null
  url文本 (uri)
  width整数
  0 到 9007199254740991
  height整数
  0 到 9007199254740991
  alt文本可为 null
  variantWidths整数列表
  0 到 9007199254740991
- isPendingtrue 或 false
images对象列表
- url文本 (uri)
- width整数
  0 到 9007199254740991
- height整数
  0 到 9007199254740991
- alt文本可为 null
- variantWidths整数列表
  0 到 9007199254740991
poll对象可为 null
- options对象列表
  id文本 (uuid)
  label文本
  voteCount整数可为 null
  0 到 9007199254740991
- totalVotes整数
  0 到 9007199254740991
- closesAt文本 (date-time)
- isClosedtrue 或 false
- allowsMultipletrue 或 false
createdAt文本 (date-time)
editedAt文本 (date-time)可为 null
body对象可为 null
- blocks多种结构之一列表
  选项 1
  type文本
  允许的值paragraph
  children多种结构之一列表
  选项 1
  type文本
  允许的值text
  text文本
  marks任意值列表
  选项 2
  type文本
  允许的值link
  href文本 (uri)
  children任意值列表
  选项 3
  type文本
  允许的值mention
  username文本
  选项 4
  type文本
  允许的值spoiler
  spoilerId文本
  children任意值列表可为 null
  选项 5
  type文本
  允许的值break
  选项 2
  type文本
  允许的值heading
  children多种结构之一列表
  选项 1
  type文本
  允许的值text
  text文本
  marks任意值列表
  选项 2
  type文本
  允许的值link
  href文本 (uri)
  children任意值列表
  选项 3
  type文本
  允许的值mention
  username文本
  选项 4
  type文本
  允许的值spoiler
  spoilerId文本
  children任意值列表可为 null
  选项 5
  type文本
  允许的值break
  选项 3
  type文本
  允许的值quote
  childrenRichTextBlock 列表
  选项 4
  type文本
  允许的值list
  isOrderedtrue 或 false
  itemsRichTextBlock 列表列表
  选项 5
  type文本
  允许的值code
  text文本
isDeletedtrue 或 false

错误

与所有操作一样，此操作在参数无效时可能返回 400，找不到内容时返回 404，请求过多时返回 429。所有错误的结构都相同。

了解错误