Нужный формат, выбранный API, параметры запроса и способ показа пользователю.
Интеграция источника, обработка ответа и правила повторных запросов.
Кому пригодится
Разработчикам развлекательных функций.
Требования и ограничения
Добавить викторины и развлекательные материалы
Скилл описывает подключение публичных API с вопросами для викторин, фактами, короткими советами и изображениями животных. Он подходит для демонстрационного приложения, бота или игровой функции. Основное внимание уделено формату ответов, повторениям вопросов и обработке ошибок при загрузке.
Выбрать источник под формат
В оригинале для викторин используется Open Trivia DB, для фактов о кошках — catfact.ninja, для медиа с собаками — random.dog. Короткие советы и факты рассматриваются через Advice Slip и Useless Facts. Актуальную доступность проверяют при интеграции: упомянутые автором сбои альтернативных сервисов не следует переносить в каталог как постоянный факт.
Организовать сеанс викторины
Для серии вопросов источник предлагает получить токен сеанса и передавать его при запросах. Это позволяет API отслеживать уже выданные вопросы. Категорию, сложность и количество задают параметрами. Приложение учитывает срок жизни токена и состояние, при котором доступный набор исчерпан: тогда требуется сброс или новый сеанс.
Подготовить данные перед показом
Вопросы могут содержать HTML-сущности либо закодированные символы, поэтому текст декодируют выбранным способом. Верный ответ приходит отдельно от неверных: их объединяют и перемешивают, чтобы позиция не выдавала решение. Каждый ответ API анализируют по коду результата, различая успех, нехватку вопросов, проблемы токена и ограничение частоты.
Обработать изображения и повторные запросы
Для медиа сначала получают JSON и извлекают ссылку. Если слот предназначен только для картинки, видеофайлы отфильтровывают. Кэширование коротких советов может давать одинаковый ответ при частых обращениях, поэтому кнопку следующего материала связывают с допустимым темпом загрузки. Частоту и размер партий вопросов сверяют с текущими правилами сервиса.
Какой результат ожидается
Для викторины результатом служит интеграция с жизненным циклом токена, читаемыми вопросами, перемешанными ответами и обработанными ошибками. Для отдельного материала сохраняют полученный элемент и адрес источника. Скилл не предназначен для справочных определений или заполнения интерфейса тестовыми пользователями. Бесплатные внешние источники требуют плана на случай недоступности, если функция становится существенной частью продукта.
Автор и источник
Оригинальное название: fun-content
Автор или репозиторий: SkillMedev/skills
Лицензия: MIT
Открыть первоисточник