- 2xx: 成功。
- 4xx: クライアントエラー(例: パラメータ不足、無効なキー)。
- 5xx: サーバーエラー(Benzinga 側で問題が発生)。
HTTP ステータスコードはエラーの主な指標ですが、レスポンスボディにはデバッグに役立つ詳細情報が含まれていることがよくあります。このボディの形式は、どの API を呼び出すかによって異なる場合があります。
多くのエンドポイント(News API など)は、シンプルな文字列、またはメッセージを含むフラットな JSON オブジェクトを返します。
- HTTP ステータスコードを確認します。
>= 400の場合はエラーとして扱います。 - レスポンスボディをログに記録します。 デバッグ目的でボディ全体をログに出力します。
- 汎用的なメッセージを表示します。 特定のエンドポイントと連携しておらず、その正確なエラー形式を把握していない場合は、ステータスコードとあわせてエンドユーザーに汎用的な「Something went wrong」メッセージを表示します。