HTTP ステータスコード
成功コード
クライアントエラーコード
サーバーエラーコード
エラーレスポンス形式
エラーレスポンスには構造化された詳細が含まれます。
エラータイプに応じて追加フィールドが存在する場合があります。
エラータイプ
部分的なエラー
一部のリクエストは部分的に成功することがあります。200 レスポンスにdata と errors の両方が含まれることがあります。
Example response
一般的なエラーのトラブルシューティング
403 Forbidden
403 Forbidden
アクセス権を確認してください:
- このエンドポイントへのアクセス権をアプリが持っているか確認
- 一部のエンドポイントは特定の登録や承認が必要
- User-context エンドポイントには適切な OAuth スコープが必要
- リソースが非公開または保護されている可能性
429 Too Many Requests
429 Too Many Requests
Rate limit に達しました:
x-rate-limit-resetヘッダーで再試行時刻を確認- 指数バックオフを実装
- レスポンスのキャッシュを検討
- 時間ウィンドウ全体にリクエストを分散
400 Bad Request
400 Bad Request
リクエストを修正してください:
- JSON 構文を検証
- 必須パラメータの欠落を確認
- パラメータの型を確認（文字列 vs. 数値）
- クエリ内の特殊文字をエスケープ
期待した post が見つからない
期待した post が見つからない
以下の要因を確認してください:
- 保護されたアカウントの post は認可がある場合のみ表示されます
- 削除された post は 404 を返します
- 一部の post は特定地域で withhold されます
- 検索クエリの構文が正しいか確認
ストリームの切断
ストリームの切断
再接続を処理:
- バックオフ付きの自動再接続を実装
- 欠落データには Recovery 機能を使用
- バッファ満杯による切断を確認（クライアントの消費が遅すぎる）
- ストリームルールが少なくとも 1 つ存在することを確認
Rate limit のヘッダー
すべてのレスポンスには rate limit の情報が含まれます。ベストプラクティス
ステータスコードを確認
レスポンスボディをパースする前に必ず HTTP ステータスを確認してください。
部分エラーを処理
200 レスポンスでも
errors 配列を確認してください。再試行ロジックを実装
429 と 5xx エラーには指数バックオフを使用してください。
リクエスト詳細をログ
デバッグ用にリクエスト ID とタイムスタンプを記録してください。
ヘルプを得る
エラーについて質問する際は、以下を含めてください。- API エンドポイント URL
- リクエストヘッダー（認証情報はマスク）
- 完全なエラーレスポンス
- 期待していた挙動
- 試したステップ
Developer Forum
質問して解決策を検索。
API Status
既知の問題を確認。