Didit APIコール最適化ガイド：CDNエッジキャッシング活用術 (JA)

レート制限の理解DiditはAPIの安定性を維持するために、グローバルおよびエンドポイント固有のレート制限を適用しており、クライアント側のスロットリングのためにX-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Resetヘッダーを提供しています。

指数関数的バックオフの実装429応答の場合、一時的なAPIの過負荷を適切に処理し、クライアント側のレート制限違反を防ぐために、指数関数的バックオフ戦略（例：5秒 → 10秒 → 20秒）を統合します。

静的アセットにCDNを活用DiditのコアAPIは従来のCDNではキャッシュできませんが、アプリケーションの静的アセット（JS、CSS、画像）をCDN経由で最適化することで、読み込み時間を短縮し、体感パフォーマンスを向上させることができます。

DiditのパフォーマンスアーキテクチャDiditのAIネイティブでグローバルに分散されたインフラストラクチャは、本質的に低レイテンシと高可用性を提供し、パフォーマンスが重要な本人確認のニーズに理想的な選択肢となります。

今日のペースの速いデジタル環境では、すべてのミリ秒が重要です。本人確認サービスを統合する開発者にとって、速度と効率性のためにAPIコールを最適化することは最重要課題です。コンテンツデリバリーネットワーク（CDN）は通常、静的アセットのキャッシュに関連付けられていますが、APIサービス、特に本人確認のような動的でリアルタイムな操作のために設計されたサービスと最適に連携する方法を理解することは、アプリケーション全体のパフォーマンスにとって不可欠です。このガイドでは、Didit API統合の最適化に焦点を当て、レート制限、効率的なコールパターン、そしてDiditのアーキテクチャがいかに高性能を本質的にサポートしているかについて深く掘り下げます。

DiditのAPIレート制限を理解する

Diditは、堅牢なAPIサービスと同様に、すべてのクライアントで安定性と公正な利用を確保するためにレート制限を実装しています。これらの制限は、乱用を防ぎ、一貫したパフォーマンスを維持するために不可欠です。それらを理解し、遵守することが、最適化されたAPIインタラクションへの第一歩です。

Diditは複数の層のレート制限を適用しています。

• グローバル制限：一般的なGETエンドポイントの場合、アプリケーションごとに1分あたり300リクエストの制限があります。同様に、POST、PATCH、DELETE（書き込み/削除）エンドポイントも、アプリケーションごとに1分あたり300リクエストというグローバルな上限があります。
• エンドポイント固有の制限：特定の高負荷な操作には、より厳しい制限があります。例えば、POST /v2/session/（Diditの本人確認や年齢推定製品を含む検証セッションの作成用）は1分あたり600リクエストに制限されています。セッション決定の取得（GET /v2/session/<id>/decision/）は過剰なポーリングを防ぐために1分あたり100リクエストに、PDF生成（GET /session/<id>/generate-pdf/）もCPU負荷が高いため1分あたり100リクエストに制限されています。

レート制限を超過すると、DiditのAPIは429 Too Many Requestsステータスコードで応答します。重要なことに、これらの応答には役立つヘッダーが含まれています。

• X-RateLimit-Limit: 許可されるリクエストの最大数。
• X-RateLimit-Remaining: 現在のウィンドウに残っているリクエスト数。
• X-RateLimit-Reset: 現在のレート制限ウィンドウがリセットされる時刻（エポック秒）。

これらのヘッダーを監視することで、アプリケーションは積極的に自己スロットリングを行い、不必要な429エラーを防ぎ、DiditのAMLスクリーニングや生体検知などのサービスでよりスムーズな運用フローを確保できます。

スマートなクライアント側スロットリングとバックオフの実装

レート制限のクライアント側での効果的な処理は、レジリエントな統合にとって不可欠です。その方法は次のとおりです。

1. レート制限ヘッダーの監視：X-RateLimit-Remainingヘッダーを読み取るロジックを実装します。この値が特定のしきい値（例：X-RateLimit-Limitの15%）を下回った場合、クライアントはリクエストレートを減速し始めるべきです。

2. 429に対する指数関数的バックオフ：これは重要な戦略です。アプリケーションが429応答を受け取った場合、リクエストを再試行する前に一時停止する必要があります。即座の再試行ではなく、指数関数的バックオフアルゴリズムを実装します。例えば、5秒、次に10秒、次に20秒と待機します。これにより、APIをさらに過負荷にすることを防ぎ、レート制限ウィンドウがリセットされるのを待ちます。DiditのRetry-Afterヘッダーもバックオフ戦略に役立ちます。

3. ログとアラート：レート制限に達したとき、および再試行がトリガーされたときを記録します。これにより、アプリケーションの使用パターンに関する貴重な洞察が得られ、最適化の領域を特定したり、特定のユースケースでDiditサポートに高い制限を要求する必要があることを示したりするのに役立ちます。

APIパフォーマンスにおけるCDNエッジキャッシングの役割

ID検証、1:1顔照合、NFC検証などのDiditのコアな本人確認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により、開発者は効率的に統合でき、開発時間と統合に関連するパフォーマンスのボトルネックを削減できます。わずか2つのAPIコールで済むプログラムによる登録プロセスは、この開発者ファーストのアプローチを象徴しています。

スマートなレート制限処理や指数関数的バックオフなどの効率的なAPI利用慣行に焦点を当てることで、Diditの高性能なAIネイティブバックエンドを最大限に活用し、シームレスで迅速な本人確認エクスペリエンスを提供できます。

Diditがどのように役立つか

Diditは、高性能で信頼性の高い本人確認エクスペリエンスを提供するように設計されています。当社のAIネイティブプラットフォームはモジュラーアーキテクチャを提供し、ID検証（OCR、MRZ、バーコードサポートを含む）、受動的・能動的生体検知、1:1顔照合、AMLスクリーニング＆モニタリングなどの特定のアイデンティティプリミティブを必要に応じて統合できます。このモジュール性により、必要なリソースのみを使用し、コストとパフォーマンスの両方を最適化できます。Diditの無料コアKYCオファリングは、セットアップ料金なしで、成功したチェックごとの支払いモデルであるため、非常に簡単に始めることができます。当社のグローバルに分散されたインフラストラクチャにより、APIコールは低レイテンシと高可用性から恩恵を受け、本人確認の動的な性質がリアルタイム処理を要求するため、API応答の従来のCDNキャッシングの必要性は低下します。私たちは、開発者に堅牢でスケーラブルなソリューションを提供し、本質的に速度と効率性を優先することで、お客様が優れたアプリケーションの構築に集中できるようにし、本人確認の信頼性に関する複雑な問題は当社が処理します。

始める準備はできましたか？

Diditの実際の動作をご覧になりたいですか？今すぐ無料デモをお試しください。

Diditの無料ティアで、無料で本人確認を開始しましょう。