技能 编程开发 Speak Webhook 事件处理

Speak Webhook 事件处理

v20260311
speak-webhooks-events
通过验证 Speak Webhook 签名、分类事件、避免重放和重复,保障语言学习服务的安全通知处理。
获取技能
346 次下载
概览

Speak Webhooks Events

Overview

Securely handle Speak webhooks with signature validation for language learning event notifications.

Prerequisites

  • Speak webhook secret configured
  • HTTPS endpoint accessible from internet
  • Understanding of cryptographic signatures
  • Redis or database for idempotency (optional)

Instructions

  1. Speak Event Types
  2. Webhook Endpoint Setup
  3. Signature Verification
  4. Event Handler Pattern
  5. Idempotency Handling
  6. Webhook Testing
  7. Local Development with ngrok

For full implementation details, load: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)

Output

  • Secure webhook endpoint
  • Signature validation enabled
  • Event handlers implemented
  • Replay attack protection active
  • Idempotency for duplicate prevention

Error Handling

Issue Cause Solution
Invalid signature Wrong secret Verify webhook secret
Timestamp rejected Clock drift Check server time sync
Duplicate events Missing idempotency Implement event ID tracking
Handler timeout Slow processing Use async queue
Event not recognized New event type Add handler or log

Resources

Next Steps

For performance optimization, see speak-performance-tuning.

Examples

Basic usage: Apply speak webhooks events to a standard project setup with default configuration options.

Advanced scenario: Customize speak webhooks events for production environments with multiple constraints and team-specific requirements.

信息
Category 编程开发
Name speak-webhooks-events
版本 v20260311
大小 4.33KB
更新时间 2026-03-12
语言