Listar posts fixados

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

Retorna os posts fixados no topo de uma comunidade.

Requisição

Shell

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

Parâmetros

id
caminhoobrigatório
ID do item, um UUID.
texto

Resposta

Uma requisição bem-sucedida responde 200 com este JSON:

itemslista de objeto
- idtexto (uuid)
- slugtexto
- communityobjeto
  idtexto (uuid)
  slugtexto
  languagetexto
  kindtexto
  Valores permitidosworkboarduser
  nametexto
  iconUrltexto (uri)pode ser null
  themetexto
  Valores permitidosvioletblueskycyanemeraldgreenyellowamberrosepink
  isSampletrue ou false
- authorobjetopode ser null
  usernametexto
  displayNametexto
  avatarUrltexto (uri)pode ser null
- authorFlairtextopode ser null
- kindtexto
  Valores permitidostextlinkimagepoll
- titletextopode ser null
- excerpttextopode ser null
- flairobjetopode ser null
  idtexto (uuid)
  labeltexto
  tonetexto
  Valores permitidosneutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
- spoilerobjetopode ser null
  workTitletextopode ser null
  unitNumbernúmeropode ser null
  No mínimo 0
- workobjetopode ser null
  idtexto (uuid)
  titletexto
  mediumtexto
  Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
  slugtexto
  unitNumbernúmeropode ser null
  No mínimo 0
- isAdulttrue ou false
- isPinnedtrue ou false
- isLockedtrue ou false
- scorenúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
- commentCountnúmero inteiro
  De 0 a 9007199254740991
- reactionslista de objeto
  kindtexto
  Valores permitidoslovelaughwowsadclapfirethinkangrypartycry
  countnúmero inteiro
  De 0 a 9007199254740991
- linkobjetopode ser null
  urltexto (uri)
  hosttexto
  titletextopode ser null
  descriptiontextopode ser null
  imageobjetopode ser null
  urltexto (uri)
  widthnúmero inteiro
  De 0 a 9007199254740991
  heightnúmero inteiro
  De 0 a 9007199254740991
  alttextopode ser null
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
  isPendingtrue ou false
- imageslista de objeto
  urltexto (uri)
  widthnúmero inteiro
  De 0 a 9007199254740991
  heightnúmero inteiro
  De 0 a 9007199254740991
  alttextopode ser null
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
- pollobjetopode ser null
  optionslista de objeto
  idtexto (uuid)
  labeltexto
  voteCountnúmero inteiropode ser null
  De 0 a 9007199254740991
  totalVotesnúmero inteiro
  De 0 a 9007199254740991
  closesAttexto (date-time)
  isClosedtrue ou false
  allowsMultipletrue ou false
- createdAttexto (date-time)
- editedAttexto (date-time)pode ser null

Erros

Como toda operação, esta pode responder 400 para parâmetros inválidos, 404 quando nada é encontrado e 429 quando você envia requisições demais. Todos os erros compartilham o mesmo formato.

Leia sobre erros