01
交換内容を説明する
各操作について、方法、リソース、必要なフィールド、および正常なレスポンスの形式を文書化してください。バリデーションエラーも含めてください。送信失敗とリクエスト拒否を区別してください:レスポンスが欠落しているからといって、状態変更操作が失敗したとは限りません。
02
資格情報は設定として扱ってください。
サーバーの資格情報はブラウザバンドルやソースリポジトリの外に保持してください。最小限の有用な権限を要求し、開発アクセスと本番アクセスを分けてください。各統合の所有者とアクセスを取り消す方法を記録してください。プロバイダーの記載された認可フローに従ってください。
03
利用不可の依存関係に備えて計画してください。
タイムアウトを設定し、レート制限のガイダンスを尊重し、操作を安全に再実行できる場合にのみ再試行してください。サポートされている場合、冪等性キーを使用して繰り返しリクエストを識別できます。リクエスト識別子と簡潔な失敗カテゴリを記録し、認証ヘッダー、セッションクッキー、および個人情報を含むペイロードは避けてください。