Vai al contenuto

Elenca i post di una community

GET/v1/communities/{id}/posts

Restituisce i post di una community con ordinamento e filtri, oppure i post che corrispondono a una ricerca.

Richiesta

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

Parametri

  • id

    percorsoobbligatorio

    Id dell'elemento, un UUID.

    testo

  • sort

    queryfacoltativo

    Ordine dei risultati.

    testo

    Valori consentitihotnewtoprising

    Predefinito: hot

  • period

    queryfacoltativo

    Intervallo di tempo per l'ordinamento per migliori.

    testo

    Valori consentitidayweekmonthyearall

    Predefinito: week

  • cursor

    queryfacoltativo

    Il valore nextCursor della pagina precedente. Omettilo per la prima pagina.

    testo

  • limit

    queryfacoltativo

    Quanti elementi restituire in una pagina.

    numero intero

    Da 1 a 25Predefinito: 25

  • flairId

    queryfacoltativo

    Solo post con questo flair.

    testo (uuid)

  • filter

    queryfacoltativo

    media per i post con immagini, units per i post su un episodio o capitolo.

    testo

    Valori consentitimediaunits
  • q

    queryfacoltativo

    Testo da cercare.

    testo

Risposta

Una richiesta riuscita risponde 200 con questo JSON:

  • itemselenco di oggetto
    • idtesto (uuid)
    • slugtesto
    • communityoggetto
      • idtesto (uuid)
      • slugtesto
      • languagetesto
      • kindtesto
        Valori consentitiworkboarduser
      • nametesto
      • iconUrltesto (uri)può essere null
      • themetesto
        Valori consentitivioletblueskycyanemeraldgreenyellowamberrosepink
      • isSampletrue o false
    • authoroggettopuò essere null
      • usernametesto
      • displayNametesto
      • avatarUrltesto (uri)può essere null
    • authorFlairtestopuò essere null
    • kindtesto
      Valori consentititextlinkimagepoll
    • titletestopuò essere null
    • excerpttestopuò essere null
    • flairoggettopuò essere null
      • idtesto (uuid)
      • labeltesto
      • tonetesto
        Valori consentitineutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
    • spoileroggettopuò essere null
      • workTitletestopuò essere null
      • unitNumbernumeropuò essere null

        Almeno 0

    • workoggettopuò essere null
      • idtesto (uuid)
      • titletesto
      • mediumtesto
        Valori consentitianimedonghuaanimationmangamanhwamanhuawebtoon
      • slugtesto
      • unitNumbernumeropuò essere null

        Almeno 0

    • isAdulttrue o false
    • isPinnedtrue o false
    • isLockedtrue o false
    • scorenumero interopuò essere null

      Da -9007199254740991 a 9007199254740991

    • commentCountnumero intero

      Da 0 a 9007199254740991

    • reactionselenco di oggetto
      • kindtesto
        Valori consentitilovelaughwowsadclapfirethinkangrypartycry
      • countnumero intero

        Da 0 a 9007199254740991

    • linkoggettopuò essere null
      • urltesto (uri)
      • hosttesto
      • titletestopuò essere null
      • descriptiontestopuò essere null
      • imageoggettopuò essere null
        • urltesto (uri)
        • widthnumero intero

          Da 0 a 9007199254740991

        • heightnumero intero

          Da 0 a 9007199254740991

        • alttestopuò essere null
        • variantWidthselenco di numero intero

          Da 0 a 9007199254740991

      • isPendingtrue o false
    • imageselenco di oggetto
      • urltesto (uri)
      • widthnumero intero

        Da 0 a 9007199254740991

      • heightnumero intero

        Da 0 a 9007199254740991

      • alttestopuò essere null
      • variantWidthselenco di numero intero

        Da 0 a 9007199254740991

    • polloggettopuò essere null
      • optionselenco di oggetto
        • idtesto (uuid)
        • labeltesto
        • voteCountnumero interopuò essere null

          Da 0 a 9007199254740991

      • totalVotesnumero intero

        Da 0 a 9007199254740991

      • closesAttesto (date-time)
      • isClosedtrue o false
      • allowsMultipletrue o false
    • createdAttesto (date-time)
    • editedAttesto (date-time)può essere null
  • nextCursortestopuò essere null

Errori

Come ogni operazione, questa può rispondere 400 per parametri non validi, 404 quando non trova nulla e 429 quando invii troppe richieste. Tutti gli errori condividono la stessa forma.

Leggi sugli errori