API 문서
REST API로 검사를 시작하고 결과와 보고서를 조회하세요.
인증
Authorization: Bearer <API_KEY> 헤더를 사용하고 키를 공개하지 마세요.
대시보드 → 설정 → API 키에서 키를 생성하세요.
curl -H "Authorization: Bearer YOUR_API_KEY" https://issafesite.com/api/v1/scan기본 URL
https://issafesite.com/api/v1요청 제한
무료: 하루 3회 검사, 분당 10회 요청. Pro: 하루 50회 검사, 분당 60회 요청. Team: 검사 무제한, 분당 300회 요청.
| 요금제 상세 | 하루 검사 | 분당 요청 |
|---|---|---|
| Free | 3 | 10 |
| Pro | 50 | 60 |
| Team | ∞ | 300 |
엔드포인트
POST /api/v1/scan은 검사를 생성하고 GET /api/v1/scan은 목록을 반환합니다. GET /api/v1/report로 보고서를 조회합니다.
POST /api/v1/scan
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 · 생성됨
GET /api/v1/scan
매개변수: 페이지=1, 개수=20 (≤50)
curl -H "Authorization: Bearer YOUR_API_KEY" "https://issafesite.com/api/v1/scan?page=1&limit=10"GET /api/v1/report
매개변수: scanId, 페이지, 개수
curl -H "Authorization: Bearer YOUR_API_KEY" "https://issafesite.com/api/v1/report?scanId=clx1abc"오류 응답
검사 생성은 202, 목록 조회는 200을 반환합니다. 오류는 error 필드가 있는 JSON이며 401은 키 누락, 403은 잘못되거나 만료된 키를 뜻합니다.
{ "error": "..." }| 400 | 매개변수가 없거나 잘못됨 |
| 401 | API 키 누락 |
| 403 | 키가 잘못되었거나 만료됨 |
| 429 | 요청 제한 또는 요금제 한도 초과 |
| 500 | 서버 내부 오류 |
빠른 시작
REST API로 검사를 시작하고 결과와 보고서를 조회하세요.
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"}'지원
요금제의 호출 한도를 확인하고 오류가 발생하면 HTTP 상태 코드와 JSON 응답을 확인하세요.
support@issafesite.com