Developer APIv1

Gwangju Security Developer API

보안 스캔 기능을 내 서비스, CI/CD 파이프라인, AI 에이전트에 직접 연동하세요. REST API와 MCP 서버를 모두 지원합니다.

API 키 무료 발급

로그인 없이 버튼 한 번으로 즉시 발급됩니다. 발급된 키는 한 번만 표시되니 바로 복사해 두세요.

로그인 불필요 · IP당 하루 3개까지 · 신용카드 불필요

Quick Start

  1. API 키 발급 — 위 버튼으로 바로 받거나, API Keys 탭에서 관리하세요.
  2. 요청 헤더에 키 추가 X-MCP-Api-Key: tsec_...
  3. 스캔 엔드포인트 호출 — 결과를 폴링하거나, MCP 서버를 통해 Claude / Cursor에서 바로 사용하세요.

예제: URL 스캔

스캔을 시작하고 3초 간격으로 폴링하면 30초 이내에 결과를 받을 수 있습니다.

# 1. 스캔 시작
curl -X POST https://api.trust-scan.me/api/v1/scan \
  -H "Content-Type: application/json" \
  -H "X-MCP-Api-Key: tsec_YOUR_KEY" \
  -d '{"url":"https://example.com","scan_mode":"quick"}'

# → { "scan_id": "abc-123", "status": "pending" }

# 2. 결과 조회 (status가 completed 될 때까지 반복)
curl https://api.trust-scan.me/api/v1/scan/abc-123 \
  -H "X-MCP-Api-Key: tsec_YOUR_KEY"

# → { "status": "completed", "score": 82, "grade": "B", ... }

요금제별 사용 한도

플랜URL 스캔저장소 스캔Rate Limit
Free5회 / 월3회 / 월분당 10 요청
Pro무제한무제한분당 120 요청

API 키 사용량은 웹 UI 스캔 횟수와 별도로 집계됩니다. 요금제 자세히 보기 →

인증 방법

모든 API 요청에 아래 헤더를 추가하세요.

X-MCP-Api-Key: tsec_YOUR_KEY_HERE

키는 항상 tsec_로 시작하며, API Keys 탭에서 발급받을 수 있습니다. 발급 직후에만 전체 값이 표시되므로 즉시 안전한 곳에 저장하세요.