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

Список персонажей произведения

GET/v1/works/{id}/characters

Возвращает персонажей одной группы ролей, например главных или второстепенных, вместе с их сэйю.

Запрос

Shell
curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72/characters?group=main"

Параметры

  • id

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

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

    текст

  • group

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

    Группа ролей персонажей.

    текст

    Допустимые значенияmainsupportingbackgroundunspecified
  • cursor

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

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

    текст

  • limit

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

    Сколько элементов вернуть на одной странице.

    целое число

    От 1 до 100По умолчанию: 60

Ответ

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

  • itemsсписок из объект
    • idтекст (uuid)
    • nameтекст
    • nativeNameтекстможет быть null
    • roleтекстможет быть null
      Допустимые значенияmainsupportingbackground
    • imageобъектможет быть null
      • urlтекст (uri)
      • widthцелое числоможет быть null

        От 0 до 9007199254740991

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

        От 0 до 9007199254740991

      • blurhashтекстможет быть null
      • providerтекстможет быть null
        Допустимые значенияanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthsсписок из целое число

        От 0 до 9007199254740991

    • slugтекст
    • voiceActorsсписок из объект
      • slugтекст
      • nameтекст
      • languageтекст
      • imageобъектможет быть null
        • urlтекст (uri)
        • widthцелое числоможет быть null

          От 0 до 9007199254740991

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

          От 0 до 9007199254740991

        • blurhashтекстможет быть null
        • providerтекстможет быть null
          Допустимые значенияanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthsсписок из целое число

          От 0 до 9007199254740991

  • nextCursorтекстможет быть null

Ошибки

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

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