跳到主要内容

集成最佳实践

遵循这些最佳实践以实现强大的 HashNut 集成。

安全​

  1. 安全 API 密钥：永远不要将密钥提交到版本控制
  2. 仅 HTTPS：所有 webhook 端点都使用 HTTPS
  3. 环境变量：将凭据存储在环境变量中

错误处理​

  1. 处理所有状态：处理所有订单状态（0-4、-1、-2、-3）
  2. 重试逻辑：为临时错误实现重试逻辑
  3. 用户友好消息：提供清晰的错误消息
  4. 日志记录：记录所有错误以便调试

订单管理​

  1. 唯一订单 ID：使用唯一的商户订单 ID
  2. 幂等性：使操作具有幂等性
  3. 状态跟踪：在数据库中跟踪订单状态
  4. 定期轮询：轮询活动订单的状态

Webhooks​

  1. 幂等性：处理重复的 webhook 交付
  2. 快速响应：在 30 秒内响应
  3. 错误处理：返回适当的错误代码

性能​

  1. 异步处理：异步处理 webhook
  2. 批量操作：尽可能批量操作
  3. 缓存：缓存链/代币信息
  4. 连接池：使用连接池

测试​

  1. 先测试网：在生产环境前在测试网上测试
  2. Webhook 测试：使用 ngrok 进行本地 webhook 测试
  3. 错误场景：测试所有错误场景
  4. 负载测试：在负载下测试

下一步​

遵循最佳实践？ 查看API 参考 →