Lister les publications populaires

GET/v1/posts

Renvoie les publications de toutes les communautés d’une langue, triées par tendances, nouveautés, meilleures ou en hausse.

Requête

Shell

curl "https://api.nogitsu.com/v1/posts?language=en"

Paramètres

sort
requêtefacultatif
Ordre des résultats.
texte
Valeurs autoriséeshotnewtoprising
Par défaut : hot
period
requêtefacultatif
Période pour le tri par meilleures.
texte
Valeurs autoriséesdayweekmonthyearall
Par défaut : week
cursor
requêtefacultatif
La valeur nextCursor de la page précédente. Omettez-la pour la première page.
texte
limit
requêtefacultatif
Nombre d’éléments à renvoyer sur une page.
nombre entier
De 1 à 25Par défaut : 25
language
requêteobligatoire
Langue des communautés à lire ; chaque langue a les siennes.
texte
Valeurs autoriséesentrdefresptitruidjakozh

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
nextCursortextepeut ê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