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

무료: 하루 3회 검사, 분당 10회 요청. Pro: 하루 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은 잘못되거나 만료된 키를 뜻합니다.

자세한 내용은 영어 원문을 확인하세요