他システムからの移行や自社システムとの連携では、API キー、ID 紐づけ、過去データの取り込みに関する質問が多く寄せられます。
キーとスコープ
用途ごとにキーを分け、必要最小限のスコープを付与します。
- 用途別のキー
- スコープの限定
- 定期的なローテーション
ID の紐づけ
自社のユーザー識別子をサーバー側の署名とともに渡します。アルゴリズムとタイムスタンプの一致に注意してください。
- 識別子を渡す
- サーバー側で署名
- ログアウト時に識別をクリア
よくある質問
移行中にサービスは止まりますか？
一定期間は並行運用し、安定を確認してから導線を切り替えるのが一般的です。
既存のチケット番号を残せますか？
はい。取り込み時に元の番号をマッピングすれば、検索の連続性を保てます。