开发者指南：优化 Didit API 调用以实现 CDN 边缘缓存 (ZH)

理解速率限制Didit 强制执行全局和特定端点的速率限制，以维护 API 稳定性，提供 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 标头用于客户端节流。

实施指数退避对于 429 响应，集成指数退避策略（例如，5s → 10s → 20s）以优雅地处理临时 API 过载并防止客户端触犯速率限制。

利用 CDN 传输静态资产虽然 Didit 的核心 API 无法通过传统 CDN 缓存，但可以通过 CDN 优化您应用程序的静态资产（JS、CSS、图像），以减少加载时间并改善感知性能。

Didit 的性能架构Didit 的 AI 原生、全球分布式基础设施本身提供低延迟和高可用性，使其成为性能关键型身份验证需求的理想选择。

在当今快节奏的数字环境中，每一毫秒都至关重要。对于集成身份验证服务的开发者而言，优化 API 调用以提高速度和效率是首要任务。虽然内容分发网络（CDN）通常与缓存静态资产相关联，但了解如何最好地与 API 服务交互，尤其是那些专为动态、实时操作（如身份验证）设计的服务，对于整体应用程序性能至关重要。本指南深入探讨了如何优化您的 Didit API 集成，重点关注速率限制、高效的调用模式以及 Didit 架构如何本身支持高性能。

理解 Didit 的 API 速率限制

Didit，与任何强大的 API 服务一样，实施速率限制以确保所有客户端的稳定性和公平使用。这些限制对于防止滥用和保持一致的性能至关重要。理解并遵守它们是优化 API 交互的第一步。

Didit 强制执行多层速率限制：

• 全局限制：对于通用的 GET 端点，每个应用程序每分钟的请求限制为 300 次。同样，POST、PATCH 和 DELETE（写入/删除）端点也具有每个应用程序每分钟 300 次请求的全局上限。
• 特定端点限制：某些高影响操作具有更严格的限制。例如，POST /v2/session/（用于创建验证会话，通常涉及 Didit 的身份验证或年龄估算产品）限制为每分钟 600 次请求。检索会话决策（`GET /v2/session//decision/）限制为每分钟 100 次请求，以防止过度轮询，而 PDF 生成（GET /session//generate-pdf/`）由于其 CPU 密集型性质也限制为每分钟 100 次请求。

当超出速率限制时，Didit 的 API 会返回 429 Too Many Requests 状态码。关键的是，这些响应包含有用的标头：

• X-RateLimit-Limit：允许的最大请求数。
• X-RateLimit-Remaining：当前窗口中剩余的请求数。
• X-RateLimit-Reset：当前速率限制窗口重置的时间（以 epoch 秒为单位）。

通过监控这些标头，您的应用程序可以主动进行自我节流，防止不必要的 429 错误，并确保像 Didit 的反洗钱筛查或活体检测等服务更流畅地运行。

实施智能客户端节流和退避

有效处理客户端的速率限制对于弹性集成至关重要。以下是操作方法：

1. 关注速率限制标头：实施逻辑来读取 X-RateLimit-Remaining 标头。当此值低于某个阈值（例如，X-RateLimit-Limit 的 15%）时，您的客户端应开始降低其请求速率。

2. 对 429 响应进行指数退避：这是一项关键策略。如果您的应用程序收到 429 响应，它应该在重试请求之前暂停。不要立即重试，而应实施指数退避算法。例如，等待 5 秒，然后 10 秒，然后 20 秒，依此类推。这可以防止进一步使 API 过载，并允许速率限制窗口重置。Didit 的 Retry-After 标头也可以指导您的退避策略。

3. 日志和警报：记录何时达到速率限制以及何时触发重试。这提供了有关应用程序使用模式的宝贵见解，并有助于识别优化区域，或表明需要向 Didit 支持请求针对特定用例的更高限制。

CDN 边缘缓存在 API 性能中的作用

尽管 Didit 的核心身份验证 API（例如用于身份验证、1:1 人脸匹配或 NFC 验证的 API）涉及动态、实时处理，无法通过 CDN 有效缓存（因为每个请求都是唯一的，需要新鲜计算），但 CDN 仍在您应用程序的整体性能中发挥作用。

CDN 擅长在更靠近用户边缘位置缓存静态内容（图像、JavaScript、CSS 文件、视频）。通过从 CDN 提供这些资产，您可以减少源服务器的负载，并降低用户的延迟。这改善了您应用程序的感知性能，使包括身份验证流程在内的整体体验感觉更快、响应更灵敏。

例如，如果您的应用程序使用涉及基于 Web 用户界面（例如，用于收集文档上传或活体检测自拍）的 Didit 工作流，则该 UI 的静态资产可以通过 CDN 提供。虽然对 Didit 后端进行验证处理的 API 调用是直接的，但周围应用程序环境的速度会显著影响用户满意度。

Didit 的 AI 原生架构实现卓越性能

Didit 从头开始就被构建为一个 AI 原生、开发者优先的身份平台。这种架构选择本身提供了显著的性能优势，补充了您针对静态资产的 CDN 策略：

• 全球分发：Didit 的基础设施在全球范围内分发，确保无论用户身处何地都能获得低延迟。这意味着对 Didit 验证端点的 API 调用会被路由到最近的数据中心，从而最大限度地减少网络传输时间。
• 针对实时优化：像被动和主动活体检测以及 1:1 人脸匹配等产品专为实时处理而设计，利用先进的 AI 模型，执行速度快且效率高。
• 可扩展性：Didit 的模块化架构专为扩展而构建，能够处理大量的验证请求而不会降低性能，即使在高峰期也是如此。这对于需要高吞吐量服务（如电话和电子邮件验证或地址证明）的应用程序至关重要。
• 开发者优先 API：清晰、文档齐全的 API 确保开发者可以高效集成，减少开发时间和潜在的集成相关性能瓶颈。只需两次 API 调用即可完成的编程注册过程，正是这种开发者优先方法的例证。

通过专注于高效的 API 使用实践，例如智能速率限制处理和指数退避，您可以充分利用 Didit 的高性能、AI 原生后端，提供无缝、快速的身份验证体验。

Didit 如何提供帮助

Didit 旨在提供高性能、可靠的身份验证体验。我们的 AI 原生平台提供模块化架构，允许您根据需要集成特定的身份原语，如身份验证（支持 OCR、MRZ 和条形码）、被动和主动活体检测、1:1 人脸匹配以及反洗钱筛查和监控。这种模块化意味着您只使用所需的资源，从而优化成本和性能。Didit 的免费核心 KYC 服务，无设置费，并采用按成功检查次数付费的模式，使其非常容易上手。我们的全球分布式基础设施确保您的 API 调用受益于低延迟和高可用性，这使得传统 API 响应的 CDN 缓存需求变得不那么相关，因为身份验证的动态特性需要实时处理。我们为开发者提供了一个健壮、可扩展的解决方案，该方案本身优先考虑速度和效率，让您能够专注于构建出色的应用程序，而我们则处理身份信任的复杂性。

准备好开始了吗？

准备好观看 Didit 的实际操作了吗？立即获取免费演示。

使用Didit 的免费套餐免费开始验证身份。