Навыки upstash-qstash
📦

upstash-qstash

Безопасно

Создавайте бессерверные очереди сообщений и запланированные задачи

Реализуйте надёжную бессерверную обмен сообщениями без управления инфраструктурой. Планируйте HTTP-задачи, cron-задания и системы доставки вебхуков с помощью Upstash QStash.

Поддерживает: Claude Codex Code(CC)
🥉 72 Бронза
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «upstash-qstash». Send a message to https://api.example.com/webhook with data

Ожидаемый результат:

Сообщение успешно опубликовано в QStash. ID сообщения: msg_1234567890. Сообщение будет доставлено на https://api.example.com/webhook с автоматическими повторными попытками. Настройте проверку подписей в вашем эндпоинте, используя ключ подписи QStash.

Использование «upstash-qstash». Create a cron job that runs every hour

Ожидаемый результат:

Cron-задание создано с расписанием: * * * * *. Эндпоинт: https://api.example.com/cron. Задача будет выполняться в начале каждого часа. Вы можете проверить доставку, проверив заголовки запроса на наличие подписи QStash.

Аудит безопасности

Безопасно
v1 • 2/25/2026

Static analysis detected 9 potential security issues, all are false positives. Line 69 contains markdown code formatting (backticks around skill names), not shell execution. Lines 3, 59, and 72 contain the word 'critical' in documentation text, not weak cryptographic algorithms. This is a pure documentation file with no executable code. Safe to publish.

1
Просканировано файлов
73
Проанализировано строк
0
находки
1
Всего аудитов
Проблем безопасности не найдено
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
31
Сообщество
100
Безопасность
100
Соответствие спецификации

Что вы можете построить

Планируйте периодическое обслуживание базы данных

Настройте повторяющиеся cron-задания для запуска очистки базы данных, операций резервного копирования или задач синхронизации данных через фиксированные интервалы без управления серверами.

Создавайте надёжную доставку вебхуков

Реализуйте системы доставки вебхуков, которые автоматически повторяют неудачные доставки и проверяют подписи, чтобы гарантировать доставку сообщений получателю.

Откладывайте тяжёлые задачи обработки

Планируйте ресурсоёмкие операции, такие как обработка видео или генерация отчётов, для выполнения позже в нерабочие часы с помощью отложенного планирования.

Попробуйте эти промпты

Отправить простое сообщение
Use the upstash-qstash skill to send a message to my endpoint https://api.example.com/tasks with the payload {"task": "process-order", "orderId": 12345}
Запланировать cron-задание
Help me set up a QStash cron job that calls https://myapp.com/cron/cleanup every day at 2 AM UTC using the upstash-qstash skill
Настроить доставку вебхуков
Using upstash-qstash, show me how to set up a message to https://webhook.site/xxx with signature verification and retry configuration
Реализовать отложенную обработку
Use upstash-qstash to schedule a message to be delivered to https://api.example.com/process in 30 minutes with deduplication enabled

Лучшие практики

  • Всегда проверяйте подписи вебхуков QStash, используя оба ключа подписи для аутентификации входящих запросов
  • Разрабатывайте эндпоинты колбэков, чтобы они быстро отвечали (в течение 30 секунд) для избежания таймаутов и правильного подтверждения
  • Используйте дедупликацию для критически важных операций, чтобы предотвратить дубликатную обработку при повторных попытках доставки

Избегать

  • Не пропускайте проверку подписей на эндпоинтах колбэков, так как это позволяет любому отправлять поддельные сообщения в вашу систему
  • Избегайте отправки больших полезных нагрузок непосредственно в сообщениях; вместо этого отправляйте ссылки или ID, чтобы сообщения оставались лёгкими
  • Не ожидайте, что QStash сможет обращаться к эндпоинтам localhost или приватной сети в продакшен-среде

Часто задаваемые вопросы

Что такое Upstash QStash?
QStash — это бессерверная очередь сообщений и сервис планирования, который надёжно доставляет HTTP-запросы на ваши эндпоинты. Вы отправляете сообщения в QStash, а он обрабатывает доставку, повторные попытки и планирование.
Как проверить подписи вебхуков?
Извлеките подпись из заголовка Upstash-Signature, проверьте её с помощью ключей подписи QStash и отклоняйте запросы с недействительными подписями. Всегда используйте как текущий, так и следующий ключ подписи во время ротации.
Могу ли я отправлять сообщения на эндпоинты localhost?
Нет, QStash не может обращаться к эндпоинтам localhost или приватной сети в продакшене. Ваши эндпоинты колбэков должны быть публично доступными. Используйте инструменты вроде ngrok для локального тестирования.
Что произойдёт, если мой эндпоинт недоступен?
QStash автоматически повторяет неудачные доставки с экспоненциальной задержкой. Вы можете настроить поведение повторных попыток и создать колбэки ошибок для обработки недоставленных сообщений.
Как работает дедупликация сообщений?
Когда вы включаете дедупликацию с ключом дедупликации, QStash гарантирует, что только одно сообщение с этим ключом будет обработано. Это предотвращает дубликатное выполнение критически важных операций при повторных попытках.
Каковы лимиты скорости?
Лимиты скорости зависят от вашего тарифа QStash. Проверьте документацию вашего тарифа для получения конкретных ограничений на количество сообщений в день и запросов в секунду. Реализуйте обработку задержек в вашем коде.

Сведения для разработчиков

Автор

sickn33

Лицензия

Apache-2.0

Ссылка

main

Структура файлов

📄 SKILL.md