Lister les publications épinglées

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

Renvoie les publications épinglées en haut d’une communauté.

Requête

Shell

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

Paramètres

id
cheminobligatoire
Identifiant de l’élément, un UUID.
texte

Réponse

Une requête réussie répond 200 avec ce JSON :

itemsliste de objet
- idtexte (uuid)
- slugtexte
- communityobjet
  idtexte (uuid)
  slugtexte
  languagetexte
  kindtexte
  Valeurs autoriséesworkboarduser
  nametexte
  iconUrltexte (uri)peut être null
  themetexte
  Valeurs autoriséesvioletblueskycyanemeraldgreenyellowamberrosepink
  isSampletrue ou false
- authorobjetpeut être null
  usernametexte
  displayNametexte
  avatarUrltexte (uri)peut être null
- authorFlairtextepeut être null
- kindtexte
  Valeurs autoriséestextlinkimagepoll
- titletextepeut être null
- excerpttextepeut être null
- flairobjetpeut être null
  idtexte (uuid)
  labeltexte
  tonetexte
  Valeurs autoriséesneutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
- spoilerobjetpeut être null
  workTitletextepeut être null
  unitNumbernombrepeut être null
  Au moins 0
- workobjetpeut être null
  idtexte (uuid)
  titletexte
  mediumtexte
  Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
  slugtexte
  unitNumbernombrepeut être null
  Au moins 0
- isAdulttrue ou false
- isPinnedtrue ou false
- isLockedtrue ou false
- scorenombre entierpeut être null
  De -9007199254740991 à 9007199254740991
- commentCountnombre entier
  De 0 à 9007199254740991
- reactionsliste de objet
  kindtexte
  Valeurs autoriséeslovelaughwowsadclapfirethinkangrypartycry
  countnombre entier
  De 0 à 9007199254740991
- linkobjetpeut être null
  urltexte (uri)
  hosttexte
  titletextepeut être null
  descriptiontextepeut être null
  imageobjetpeut être null
  urltexte (uri)
  widthnombre entier
  De 0 à 9007199254740991
  heightnombre entier
  De 0 à 9007199254740991
  alttextepeut être null
  variantWidthsliste de nombre entier
  De 0 à 9007199254740991
  isPendingtrue ou false
- imagesliste de objet
  urltexte (uri)
  widthnombre entier
  De 0 à 9007199254740991
  heightnombre entier
  De 0 à 9007199254740991
  alttextepeut être null
  variantWidthsliste de nombre entier
  De 0 à 9007199254740991
- pollobjetpeut être null
  optionsliste de objet
  idtexte (uuid)
  labeltexte
  voteCountnombre entierpeut être null
  De 0 à 9007199254740991
  totalVotesnombre entier
  De 0 à 9007199254740991
  closesAttexte (date-time)
  isClosedtrue ou false
  allowsMultipletrue ou false
- createdAttexte (date-time)
- editedAttexte (date-time)peut être null

Erreurs

Comme toutes les opérations, celle-ci peut répondre 400 en cas de paramètres invalides, 404 lorsque rien n’est trouvé et 429 lorsque vous envoyez trop de requêtes. Toutes les erreurs partagent la même forme.

En savoir plus sur les erreurs