2TECH.WORK
2TECH.WORK / PLATFORM

明確な契約でサービスを接続する

信頼できる統合は、明示的なリクエスト、予測可能なレスポンス、注意深く制限されたアクセスから始まります。

詳細を読む
このページで説明されているアーキテクチャと接続。
01

交換内容を説明する

各操作について、方法、リソース、必要なフィールド、および正常なレスポンスの形式を文書化してください。バリデーションエラーも含めてください。送信失敗とリクエスト拒否を区別してください:レスポンスが欠落しているからといって、状態変更操作が失敗したとは限りません。

02

資格情報は設定として扱ってください。

サーバーの資格情報はブラウザバンドルやソースリポジトリの外に保持してください。最小限の有用な権限を要求し、開発アクセスと本番アクセスを分けてください。各統合の所有者とアクセスを取り消す方法を記録してください。プロバイダーの記載された認可フローに従ってください。

03

利用不可の依存関係に備えて計画してください。

タイムアウトを設定し、レート制限のガイダンスを尊重し、操作を安全に再実行できる場合にのみ再試行してください。サポートされている場合、冪等性キーを使用して繰り返しリクエストを識別できます。リクエスト識別子と簡潔な失敗カテゴリを記録し、認証ヘッダー、セッションクッキー、および個人情報を含むペイロードは避けてください。