İçeriğe geç

Toplulukları listele

GET/v1/communities

Bir dilin topluluklarını üye sayısına, etkinliğe ya da yaşa göre; tür ve kategori süzgeçleriyle döndürür.

İstek

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

Parametreler

  • language

    sorguzorunlu

    Okunacak toplulukların dili; her dilin kendi toplulukları vardır.

    metin

    İzin verilen değerlerentrdefresptitruidjakozh
  • kind

    sorguisteğe bağlı

    Yalnızca bu türdeki topluluklar: bir eserin topluluğu, bir konu panosu ya da bir üyenin kurduğu topluluk.

    metin

    İzin verilen değerlerworkboarduser
  • category

    sorguisteğe bağlı

    Yalnızca bu kategorideki topluluklar.

    metin

    İzin verilen değerleranimemangamanhwawebtoongenresfan_artgeneral
  • sort

    sorguisteğe bağlı

    Sonuçların sırası.

    metin

    İzin verilen değerlermembersactivenew

    Varsayılan: members

  • q

    sorguisteğe bağlı

    Aranacak metin.

    metin

  • 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 24 arasıVarsayılan: 24

Yanıt

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

  • itemsnesne listesi
    • idmetin (uuid)
    • slugmetin
    • languagemetin
    • kindmetin
      İzin verilen değerlerworkboarduser
    • namemetin
    • iconUrlmetin (uri)null olabilir
    • thememetin
      İzin verilen değerlervioletblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue ya da false
    • categorymetin
      İzin verilen değerleranimemangamanhwawebtoongenresfan_artgeneral
    • descriptionmetinnull olabilir
    • memberCounttam sayı

      0 ile 9007199254740991 arası

    • postCounttam sayı

      0 ile 9007199254740991 arası

    • isAdulttrue ya da false
  • 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