İçeriğe geç

Eserleri listele

GET/v1/works

Eserleri sayfa sayfa; popülerliğe, puana, en yeniye ya da en yakına göre sıralı döndürür. Listeyi ortam, tür, sezon, yayın durumu ya da okuma yönüyle daralt.

İstek

Shell
curl "https://api.nogitsu.com/v1/works?medium=anime&limit=3"

Parametreler

  • medium

    sorguisteğe bağlı

    Yalnızca bu ortamdaki eserler.

    metin

    İzin verilen değerleranimedonghuaanimationmangamanhwamanhuawebtoon
  • releaseStatus

    sorguisteğe bağlı

    Yalnızca bu yayın durumundaki eserler.

    metin

    İzin verilen değerlernot_yet_releasedreleasingfinishedhiatuscancelledunknown
  • readingDirection

    sorguisteğe bağlı

    Yalnızca bu yönde okunan eserler.

    metin

    İzin verilen değerlerrtlltrvertical_scroll
  • genre

    sorguisteğe bağlı

    Yalnızca bu türdeki eserler, slug ile.

    metin

  • hasBanner

    sorguisteğe bağlı

    Yalnızca banner görseli olan eserler için true.

    metin

  • hasTrailer

    sorguisteğe bağlı

    Yalnızca fragmanı olan eserler için true.

    metin

  • minCoverWidth

    sorguisteğe bağlı

    Yalnızca kapağı en az bu kadar piksel geniş olan eserler.

    tam sayı

    1 ile 10000 arası

  • season

    sorguisteğe bağlı

    Yalnızca bu sezonda başlayan eserler.

    metin

    İzin verilen değerlerwinterspringsummerfall
  • seasonYear

    sorguisteğe bağlı

    Sezonun yılı; season ile birlikte kullan.

    tam sayı

    1900 ile 2100 arası

  • sort

    sorguisteğe bağlı

    Sonuçların sırası.

    metin

    İzin verilen değerlerpopularityscorenewestsoonest

    Varsayılan: popularity

  • limit

    sorguisteğe bağlı

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

    tam sayı

    1 ile 50 arasıVarsayılan: 20

  • cursor

    sorguisteğe bağlı

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

    metin

  • language

    sorguisteğe bağlı

    Yanıttaki metinler için en ya da tr gibi iki harfli dil kodu. İngilizce için verme.

    metin

    Varsayılan: en

Yanıt

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

  • itemsnesne listesi
    • idmetin (uuid)
    • slugmetin
    • mediummetin
      İzin verilen değerleranimedonghuaanimationmangamanhwamanhuawebtoon
    • publicationFormatmetin
      İzin verilen değerlertvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
    • releaseStatusmetin
      İzin verilen değerlernot_yet_releasedreleasingfinishedhiatuscancelledunknown
    • readingDirectionmetinnull olabilir
      İzin verilen değerlerrtlltrvertical_scroll
    • primaryTitlemetin
    • englishTitlemetinnull olabilir
    • nativeTitlemetinnull olabilir
    • romanizedTitlemetinnull olabilir
    • contentRatingmetin
      İzin verilen değerlerunknownall_agesteenmatureadult
    • seasonmetinnull olabilir
      İzin verilen değerlerwinterspringsummerfall
    • seasonYeartam sayınull olabilir

      -9007199254740991 ile 9007199254740991 arası

    • startDatemetin (date)null olabilir
    • totalUnitstam sayınull olabilir

      -9007199254740991 ile 9007199254740991 arası

    • aggregateScoretam sayınull olabilir

      0 ile 1000 arası

    • scoreRanktam sayınull olabilir

      0 ile 9007199254740991 arası

    • popularityRanktam sayınull olabilir

      0 ile 9007199254740991 arası

    • audienceSizetam sayınull olabilir

      0 ile 9007199254740991 arası

    • covernesnenull olabilir
      • urlmetin (uri)
      • widthtam sayınull olabilir

        0 ile 9007199254740991 arası

      • heighttam sayınull olabilir

        0 ile 9007199254740991 arası

      • blurhashmetinnull olabilir
      • providermetinnull olabilir
        İzin verilen değerleranime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthstam sayı listesi

        0 ile 9007199254740991 arası

    • bannernesnenull olabilir
      • urlmetin (uri)
      • widthtam sayınull olabilir

        0 ile 9007199254740991 arası

      • heighttam sayınull olabilir

        0 ile 9007199254740991 arası

      • blurhashmetinnull olabilir
      • providermetinnull olabilir
        İzin verilen değerleranime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthstam sayı listesi

        0 ile 9007199254740991 arası

    • trailernesnenull olabilir
      • hostmetin
        İzin verilen değerleryoutube
      • keymetin
    • primaryStudiometinnull olabilir
    • genresnesne listesi
      • slugmetin
      • labelmetin
    • contentWarningsmetin listesi
      İzin verilen değerlerviolencegoresexual-contentsuicide
    • descriptionnesnenull olabilir
      • textmetin
      • languagemetin
      • isMachineGeneratedtrue ya da false
    • sourceUrlmetin (uri)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