İçeriğe geç

Bir eserin incelemelerini listele

GET/v1/works/{id}/reviews

Bir eserin yayımlanmış incelemelerini faydaya, tarihe ya da puana göre sıralı ve süzgeçlerle döndürür.

İstek

Shell
curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72/reviews"

Parametreler

  • id

    yolzorunlu

    Öğenin kimliği, bir UUID.

    metin

  • sort

    sorguisteğe bağlı

    Sonuçların sırası.

    metin

    İzin verilen değerlerhelpfulnewesthighestlowest

    Varsayılan: helpful

  • score

    sorguisteğe bağlı

    Yalnızca bu puanı veren incelemeler.

    tam sayı

    1 ile 10 arası

  • language

    sorguisteğe bağlı

    Yalnızca bu dilde yazılmış incelemeler.

    metin

  • completedOnly

    sorguisteğe bağlı

    Yalnızca eseri bitiren üyelerin incelemeleri için true.

    metin

  • detailed

    sorguisteğe bağlı

    Yalnızca 600 karakter ve üzeri uzun incelemeler için true.

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

Yanıt

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

  • itemsnesne listesi
    • idmetin (uuid)
    • authornesne
      • usernamemetin
      • displayNamemetin
      • avatarUrlmetin (uri)null olabilir
    • titlemetinnull olabilir
    • bodynesnenull olabilir
      • blocksbirkaç biçimden biri listesi
        1. Seçenek 1

          • typemetin
            İzin verilen değerlerparagraph
          • childrenbirkaç biçimden biri listesi
            1. Seçenek 1

            2. Seçenek 2

            3. Seçenek 3

            4. Seçenek 4

            5. Seçenek 5

        2. Seçenek 2

          • typemetin
            İzin verilen değerlerheading
          • childrenbirkaç biçimden biri listesi
            1. Seçenek 1

            2. Seçenek 2

            3. Seçenek 3

            4. Seçenek 4

            5. Seçenek 5

        3. Seçenek 3

          • typemetin
            İzin verilen değerlerquote
          • childrenRichTextBlock listesi
        4. Seçenek 4

          • typemetin
            İzin verilen değerlerlist
          • isOrderedtrue ya da false
          • itemsRichTextBlock listesi listesi
        5. Seçenek 5

          • typemetin
            İzin verilen değerlercode
          • textmetin
    • bodyLengthtam sayı

      0 ile 9007199254740991 arası

    • hasSpoilertrue ya da false
    • spoilerUnitsayınull olabilir

      En az 0

    • sourceSpoilernesnenull olabilir
      • kindmetin
        İzin verilen değerlermangamanhwamanhuawebtoonnovelother
      • unitsayınull olabilir

        En az 0

    • prosmetin listesinull olabilir
    • consmetin listesinull olabilir
    • 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ı

    • languagemetin
    • scoreHalfPointstam sayınull olabilir

      1 ile 20 arası

    • categoryScoresnesne
    • trackingStatusmetinnull olabilir
      İzin verilen değerlerplannedcurrentcompletedpauseddroppedrewatching
    • progressUnitssayınull olabilir

      En az 0

    • progressTotaltam sayınull olabilir

      0 ile 9007199254740991 arası

    • repeatCounttam sayı

      0 ile 9007199254740991 arası

    • authorStatsnesne
      • reviewCounttam sayı

        0 ile 9007199254740991 arası

      • helpfulCounttam sayı

        0 ile 9007199254740991 arası

    • helpfulCounttam sayı

      0 ile 9007199254740991 arası

    • unhelpfulCounttam sayı

      0 ile 9007199254740991 arası

    • replyCounttam sayı

      0 ile 9007199254740991 arası

    • 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