システム連携

TWPと外部システムを連携する際のポイントを説明します。

連携方式

TWP APIを使用して、外部システムとデータを連携できます。

既存の認証基盤と連携して、シングルサインオンを実現できます。

API呼び出し時は、適切なエラーハンドリングを実装してください。

try {
  // API呼び出し
} catch (error) {
  if (error.status === 401) {
    // トークン更新
  } else if (error.status === 429) {
    // レート制限対応
  }
}

レート制限を超えないよう、以下の対策を推奨します。

POST/PUT/DELETEリクエストは、リトライ時に重複処理が発生しないよう考慮してください。

TWPからのイベント通知を受け取ることができます。

本番環境に影響を与えないよう、開発環境でテストを行ってください。

テスト用のプロジェクト・タスクを作成し、連携の動作確認を行ってください。