Перейти к содержимому

Список комментариев

GET/v1/posts/{id}/comments

Возвращает дерево комментариев поста постранично, с сортировкой, фильтром по серии, отдельной веткой или текстовым поиском.

Запрос

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

Параметры

  • id

    путьобязательный

    Идентификатор элемента, UUID.

    текст

  • sort

    запроснеобязательный

    Порядок результатов.

    текст

    Допустимые значенияbestnewoldcontroversialunit

    По умолчанию: best

  • unit

    запроснеобязательный

    Только комментарии к этому номеру серии или главы либо general для комментариев, не привязанных к ним.

    один из нескольких форматов

  • thread

    запроснеобязательный

    Только ветка под этим комментарием.

    текст (uuid)

  • q

    запроснеобязательный

    Текст для поиска.

    текст

  • cursor

    запроснеобязательный

    Значение nextCursor с предыдущей страницы. Не указывайте для первой страницы.

    текст

Ответ

Успешный запрос отвечает 200 с таким JSON:

  • itemsсписок из __schema0
    • idтекст (uuid)
    • authorобъектможет быть null
      • usernameтекст
      • displayNameтекст
      • avatarUrlтекст (uri)может быть null
    • authorFlairтекстможет быть null
    • authorProgressобъектможет быть null
      • trackingStatusтекст
        Допустимые значенияplannedcurrentcompletedpauseddroppedrewatching
      • progressUnitsчисломожет быть null

        Не меньше 0

      • progressTotalцелое числоможет быть null

        От 0 до 9007199254740991

    • stateтекст
      Допустимые значенияpublishedremoveddeleted
    • bodyобъектможет быть null
      • blocksсписок из один из нескольких форматов

        1. Вариант 1

          • typeтекст
            Допустимые значенияparagraph
          • childrenсписок из любое значение

        2. Вариант 2

          • typeтекст
            Допустимые значенияheading
          • childrenсписок из любое значение

        3. Вариант 3

          • typeтекст
            Допустимые значенияquote
          • childrenсписок из RichTextBlock

        4. Вариант 4

          • typeтекст
            Допустимые значенияlist
          • isOrderedtrue или false
          • itemsсписок из список из любое значение

        5. Вариант 5

          • typeтекст
            Допустимые значенияcode
          • textтекст
    • hasSpoilertrue или false
    • unitNumberчисломожет быть null

      Не меньше 0

    • sourceSpoilerобъектможет быть null
      • kindтекст
        Допустимые значенияmangamanhwamanhuawebtoonnovelother
      • unitчисломожет быть null

        Не меньше 0

    • imagesсписок из объект
      • urlтекст (uri)
      • widthцелое число

        От 0 до 9007199254740991

      • heightцелое число

        От 0 до 9007199254740991

      • altтекстможет быть null
      • variantWidthsсписок из целое число

        От 0 до 9007199254740991

    • linkобъектможет быть null
      • urlтекст (uri)
      • hostтекст
      • titleтекстможет быть null
      • descriptionтекстможет быть null
      • imageобъектможет быть null
        • urlтекст (uri)
        • widthцелое число

          От 0 до 9007199254740991

        • heightцелое число

          От 0 до 9007199254740991

        • altтекстможет быть null
        • variantWidthsсписок из целое число

          От 0 до 9007199254740991

      • isPendingtrue или false
    • scoreцелое числоможет быть null

      От -9007199254740991 до 9007199254740991

    • reactionsсписок из объект
      • kindтекст
        Допустимые значенияlovelaughwowsadclapfirethinkangrypartycry
      • countцелое число

        От 0 до 9007199254740991

    • isByPostAuthortrue или false
    • isByModeratortrue или false
    • createdAtтекст (date-time)
    • editedAtтекст (date-time)может быть null
    • depthцелое число

      От 0 до 9007199254740991

    • replyCountцелое число

      От 0 до 9007199254740991

    • repliesсписок из __schema0
  • nextCursorтекстможет быть null

Ошибки

Как и любая операция, эта может ответить 400 при неверных параметрах, 404, если ничего не найдено, и 429, если вы отправляете слишком много запросов. У всех ошибок один формат.

Подробнее об ошибках