Zum Inhalt springen

Beliebte Beiträge auflisten

GET/v1/posts

Liefert Beiträge aus allen Communitys einer Sprache, sortiert nach angesagt, neu, top oder im Kommen.

Anfrage

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

Parameter

  • 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

  • language

    Queryerforderlich

    Sprache der zu lesenden Communitys; jede Sprache hat ihre eigenen.

    Text

    Erlaubte Werteentrdefresptitruidjakozh

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