Skip to content
IsSafeSite

API ドキュメント

REST API で診断を作成し、結果とレポートを取得します。

認証

Authorization: Bearer <API_KEY> ヘッダーを使用します。キーを公開しないでください。

エンドポイント

POST /api/v1/scan で診断を作成し、GET /api/v1/scan で一覧を取得します。GET /api/v1/report でレポートを取得します。

制限とエラー

プランの利用上限を確認してください。失敗時は HTTP ステータスと JSON 応答で認証、入力、レート制限を確認します。

ダッシュボード → 設定 → API キーでキーを作成します。

https://issafesite.com/api/v1

無料: 1日3スキャン、毎分10リクエスト。Pro: 1日50スキャン、毎分60リクエスト。Team: スキャン無制限、毎分300リクエスト。

POST の本文には url が必須です。depth は QUICK、STANDARD(既定)、DEEP。一覧には page(既定1)、limit(既定20、最大50)を指定でき、レポートは scanId で絞り込めます。

curl -X POST https://issafesite.com/api/v1/scan \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","depth":"STANDARD"}'

スキャン作成は202、一覧は200です。エラーは error フィールドを持つ JSON で、401 はキーなし、403 は無効または期限切れのキーです。

詳細は英語版をご覧ください