列出置顶帖

GET/v1/communities/{id}/pinned-posts

返回置顶在社区顶部的帖子。

请求

Shell

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

参数

id
路径必填
条目的 ID，为 UUID。
文本

响应

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

items对象列表
- 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

错误

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

了解错误