İçeriğe geç

Bir topluluğun gönderilerini listele

GET/v1/communities/{id}/posts

Bir topluluğun gönderilerini sıralama ve süzgeçlerle ya da bir aramaya uyan gönderileri döndürür.

İstek

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

Parametreler

  • id

    yolzorunlu

    Öğenin kimliği, bir UUID.

    metin

  • sort

    sorguisteğe bağlı

    Sonuçların sırası.

    metin

    İzin verilen değerlerhotnewtoprising

    Varsayılan: hot

  • period

    sorguisteğe bağlı

    En iyi sıralaması için zaman penceresi.

    metin

    İzin verilen değerlerdayweekmonthyearall

    Varsayılan: week

  • cursor

    sorguisteğe bağlı

    Önceki sayfadaki nextCursor değeri. İlk sayfa için verme.

    metin

  • limit

    sorguisteğe bağlı

    Bir sayfada kaç öğe döneceği.

    tam sayı

    1 ile 25 arasıVarsayılan: 25

  • flairId

    sorguisteğe bağlı

    Yalnızca bu etiketi taşıyan gönderiler.

    metin (uuid)

  • filter

    sorguisteğe bağlı

    Görsel gönderileri için media, bir bölümle ilgili gönderiler için units.

    metin

    İzin verilen değerlermediaunits
  • q

    sorguisteğe bağlı

    Aranacak metin.

    metin

Yanıt

Başarılı istek bu JSON ile 200 döndürür:

  • itemsnesne listesi
    • idmetin (uuid)
    • slugmetin
    • communitynesne
      • idmetin (uuid)
      • slugmetin
      • languagemetin
      • kindmetin
        İzin verilen değerlerworkboarduser
      • namemetin
      • iconUrlmetin (uri)null olabilir
      • thememetin
        İzin verilen değerlervioletblueskycyanemeraldgreenyellowamberrosepink
      • isSampletrue ya da false
    • authornesnenull olabilir
      • usernamemetin
      • displayNamemetin
      • avatarUrlmetin (uri)null olabilir
    • authorFlairmetinnull olabilir
    • kindmetin
      İzin verilen değerlertextlinkimagepoll
    • titlemetinnull olabilir
    • excerptmetinnull olabilir
    • flairnesnenull olabilir
      • idmetin (uuid)
      • labelmetin
      • tonemetin
        İzin verilen değerlerneutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
    • spoilernesnenull olabilir
      • workTitlemetinnull olabilir
      • unitNumbersayınull olabilir

        En az 0

    • worknesnenull olabilir
      • idmetin (uuid)
      • titlemetin
      • mediummetin
        İzin verilen değerleranimedonghuaanimationmangamanhwamanhuawebtoon
      • slugmetin
      • unitNumbersayınull olabilir

        En az 0

    • isAdulttrue ya da false
    • isPinnedtrue ya da false
    • isLockedtrue ya da false
    • scoretam sayınull olabilir

      -9007199254740991 ile 9007199254740991 arası

    • commentCounttam sayı

      0 ile 9007199254740991 arası

    • reactionsnesne listesi
      • kindmetin
        İzin verilen değerlerlovelaughwowsadclapfirethinkangrypartycry
      • counttam sayı

        0 ile 9007199254740991 arası

    • linknesnenull olabilir
      • urlmetin (uri)
      • hostmetin
      • titlemetinnull olabilir
      • descriptionmetinnull olabilir
      • imagenesnenull olabilir
        • urlmetin (uri)
        • widthtam sayı

          0 ile 9007199254740991 arası

        • heighttam sayı

          0 ile 9007199254740991 arası

        • altmetinnull olabilir
        • variantWidthstam sayı listesi

          0 ile 9007199254740991 arası

      • isPendingtrue ya da false
    • imagesnesne listesi
      • urlmetin (uri)
      • widthtam sayı

        0 ile 9007199254740991 arası

      • heighttam sayı

        0 ile 9007199254740991 arası

      • altmetinnull olabilir
      • variantWidthstam sayı listesi

        0 ile 9007199254740991 arası

    • pollnesnenull olabilir
      • optionsnesne listesi
        • idmetin (uuid)
        • labelmetin
        • voteCounttam sayınull olabilir

          0 ile 9007199254740991 arası

      • totalVotestam sayı

        0 ile 9007199254740991 arası

      • closesAtmetin (date-time)
      • isClosedtrue ya da false
      • allowsMultipletrue ya da false
    • createdAtmetin (date-time)
    • editedAtmetin (date-time)null olabilir
  • nextCursormetinnull olabilir

Hatalar

Her işlem gibi bu işlem de geçersiz parametrede 400, bir şey bulunamadığında 404 ve çok fazla istek gönderdiğinde 429 döndürebilir. Tüm hatalar aynı biçimi paylaşır.

Hatalar hakkında oku