エラー

javinfo API が返す HTTP ステータスコードとエラーボディの形式。

エラーは標準の HTTP ステータスコードを使用します。失敗したリクエストは課金されません — 成功した 200 レスポンスに対してのみ支払います。

ステータスコード

ステータス	意味
`400`	不正なリクエスト — 未知のプロバイダーID、または認証済みセッションでのキー欠落。
`401`	API キーが欠落または無効。
`402`	残高不足 — アカウントにチャージしてください。料金を参照。
`404`	結果が見つかりません（全プロバイダーが該当なし、または `/random` のインデックスが空）。
`429`	レート制限または1日の割り当てを超過。`Retry-After` ヘッダーに従って再試行してください。
`499`	プロバイダーが応答する前にクライアントがリクエストを閉じました。

エラーは、機械可読な code と人間可読な message を含む JSON ボディを返します：

{
  "code": "NOT_FOUND",
  "message": "No result found for \"SSIS-999\"."
}

レート制限に達した場合は、Retry-After レスポンスヘッダー（秒）に従ってバックオフします：

if (res.status === 429) {
  const wait = Number(res.headers.get('Retry-After') ?? 1);
  await new Promise((r) => setTimeout(r, wait * 1000));
}