Zum Inhalt springen

Beiträge einer Community auflisten

GET/v1/communities/{id}/posts

Liefert die Beiträge einer Community mit Sortierung und Filtern oder die Beiträge, die zu einer Suche passen.

Anfrage

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

Parameter

  • id

    Pfaderforderlich

    ID des Elements, eine UUID.

    Text

  • sort

    Queryoptional

    Reihenfolge der Ergebnisse.

    Text

    Erlaubte Wertehotnewtoprising

    Standard: hot

  • period

    Queryoptional

    Zeitfenster für die Top-Sortierung.

    Text

    Erlaubte Wertedayweekmonthyearall

    Standard: week

  • cursor

    Queryoptional

    Der nextCursor-Wert der vorherigen Seite. Lass ihn für die erste Seite weg.

    Text

  • limit

    Queryoptional

    Wie viele Elemente eine Seite liefern soll.

    Ganzzahl

    Von 1 bis 25Standard: 25

  • flairId

    Queryoptional

    Nur Beiträge mit diesem Flair.

    Text (uuid)

  • filter

    Queryoptional

    media für Bildbeiträge, units für Beiträge zu einer Folge oder einem Kapitel.

    Text

    Erlaubte Wertemediaunits
  • q

    Queryoptional

    Zu suchender Text.

    Text

Antwort

Eine erfolgreiche Anfrage antwortet mit 200 und diesem JSON:

  • itemsListe von Objekt
    • idText (uuid)
    • slugText
    • communityObjekt
      • idText (uuid)
      • slugText
      • languageText
      • kindText
        Erlaubte Werteworkboarduser
      • nameText
      • iconUrlText (uri)kann null sein
      • themeText
        Erlaubte Wertevioletblueskycyanemeraldgreenyellowamberrosepink
      • isSampletrue oder false
    • authorObjektkann null sein
      • usernameText
      • displayNameText
      • avatarUrlText (uri)kann null sein
    • authorFlairTextkann null sein
    • kindText
      Erlaubte Wertetextlinkimagepoll
    • titleTextkann null sein
    • excerptTextkann null sein
    • flairObjektkann null sein
      • idText (uuid)
      • labelText
      • toneText
        Erlaubte Werteneutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
    • spoilerObjektkann null sein
      • workTitleTextkann null sein
      • unitNumberZahlkann null sein

        Mindestens 0

    • workObjektkann null sein
      • idText (uuid)
      • titleText
      • mediumText
        Erlaubte Werteanimedonghuaanimationmangamanhwamanhuawebtoon
      • slugText
      • unitNumberZahlkann null sein

        Mindestens 0

    • isAdulttrue oder false
    • isPinnedtrue oder false
    • isLockedtrue oder false
    • scoreGanzzahlkann null sein

      Von -9007199254740991 bis 9007199254740991

    • commentCountGanzzahl

      Von 0 bis 9007199254740991

    • reactionsListe von Objekt
      • kindText
        Erlaubte Wertelovelaughwowsadclapfirethinkangrypartycry
      • countGanzzahl

        Von 0 bis 9007199254740991

    • linkObjektkann null sein
      • urlText (uri)
      • hostText
      • titleTextkann null sein
      • descriptionTextkann null sein
      • imageObjektkann null sein
        • urlText (uri)
        • widthGanzzahl

          Von 0 bis 9007199254740991

        • heightGanzzahl

          Von 0 bis 9007199254740991

        • altTextkann null sein
        • variantWidthsListe von Ganzzahl

          Von 0 bis 9007199254740991

      • isPendingtrue oder false
    • imagesListe von Objekt
      • urlText (uri)
      • widthGanzzahl

        Von 0 bis 9007199254740991

      • heightGanzzahl

        Von 0 bis 9007199254740991

      • altTextkann null sein
      • variantWidthsListe von Ganzzahl

        Von 0 bis 9007199254740991

    • pollObjektkann null sein
      • optionsListe von Objekt
        • idText (uuid)
        • labelText
        • voteCountGanzzahlkann null sein

          Von 0 bis 9007199254740991

      • totalVotesGanzzahl

        Von 0 bis 9007199254740991

      • closesAtText (date-time)
      • isClosedtrue oder false
      • allowsMultipletrue oder false
    • createdAtText (date-time)
    • editedAtText (date-time)kann null sein
  • nextCursorTextkann null sein

Fehler

Wie jede Operation kann auch diese mit 400 bei ungültigen Parametern antworten, mit 404, wenn nichts gefunden wird, und mit 429, wenn du zu viele Anfragen sendest. Alle Fehler haben dieselbe Form.

Mehr über Fehler