記事テンプレート

XM Discover API概要について

XM Discover APIにより、開発者はXM Discoverの感情およびテキスト分析機能にアクセスし、サードパーティのアプリケーションで使用することができます。

利用可能なAPIサービス

以下のAPIリクエストはRESTful APIで利用可能です：

• 輸出 API:分類、感情、その他のメタデータで強化されたフィードバックデータをエクスポートします。
• インポート API:XM Discoverにドキュメントをインポートします。

レガシーAPIサービス

XM Discoverは、メンテナンスモードで多くのレガシーAPIサービスをサポートしています。可能であれば、サポートされているApiサービスに切り替えてください。

• リアルタイム・サービスとアドホック・アップロード・サービス機能が、Import APIとXM Discover Linkコネクタを通じてサポートされるようになりました。
• ModelサービスやDataflowサービスのような他のサービスには、サポートされているAPIアナログがない。これらのレガシーエンドポイントに関するドキュメントのご請求は、クアルトリクスサポートまでご連絡ください。
• 積極的にExport API v1を使用している場合は、Export API v2に切り替えてください。

APIレート制限

デフォルトでは、APIコールを行う速度に制限があります。デフォルトのAPIレート制限は以下の通り：

• 1秒あたりの通話回数：65回
• 秒間リアルタイム文字数：200,000文字

料金制限の引き上げをご希望の場合は、XM Discoverサポートまで、ご利用のケースに関する情報を添えてご連絡ください。

APIレート制限の例

秒単位のリアルタイム文字数制限は、メッセージレベルで適用されるため、秒単位の呼数制限とは異なる。以下は、毎秒20,000文字に設定されていると仮定した場合のシステム動作の例である：

1. まず、4万文字のリアルタイムリクエストが届く。このリクエストは受理される。
2. 他のリクエストが2秒以内に到着した場合、そのリクエストはRATE_LIMIT エラーメッセージとともに拒否される。
3. 2秒後に別のリクエストが到着した場合、そのリクエストは受け入れられる。