障害レポート

障害レポート

プロキシ IP がブロックされたり失敗したりした際に報告することで、HydraSkill のルーティング判断の改善に役立ちます。

エンドポイント

POST /v1/proxy/{proxy_id}/report

パラメータ

パラメータ	型	説明
reason	string	blocked、captcha、timeout、rate_limited
status_code	integer	受信した HTTP ステータスコード
target_url	string	ブロックされた URL

リクエスト

curl -X POST "https://api.hydraskill.ai/v1/proxy/px_abc123/report" \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"reason": "blocked", "status_code": 403}'

レスポンス

{
  "acknowledged": true,
  "action_taken": "ip_rotated",
  "new_proxy_id": "px_def456"
}

補足

Auto-Heal を有効にしている場合、障害は自動的に検知・処理されます。このエンドポイントは Auto-Heal を無効にしている場合、または手動でレポートする場合にのみ使用してください。