Public API v1
안정적인 외부 계약 — API 키 인증, 스코프, 엔드포인트
Base URL: https://api-gateway-production-20f8.up.railway.app/v1
OpenAPI: https://api-gateway-production-20f8.up.railway.app/openapi/v1.json
인증
다음 중 하나:
X-Aimon-Api-Key: aimon_live_…Authorization: Bearer aimon_live_…
응답에는 "apiVersion": "v1"이 포함되어 버전 호환을 확인할 수 있습니다.
엔드포인트
| Method | Path | Scope | 설명 |
|---|---|---|---|
| POST | /v1/vision/detections | vision:ingest | 외부 Vision 탐지 단건 ingest |
| GET | /v1/incidents | incident:read | 인시던트 목록 |
| GET | /v1/incidents/:id | incident:read | 인시던트 상세 |
| POST | /v1/incidents | incident:write | 인시던트 생성 |
예시
curl "https://api-gateway-production-20f8.up.railway.app/v1/incidents?siteId=site_demo" \
-H "X-Aimon-Api-Key: aimon_live_..."Rate limit
테넌트 플랜별 분당 요청 한도가 적용됩니다. 초과 시 429와 retryAfterSec을 반환합니다.
BFF vs Public API
Console·내부 도구는 JWT 기반
/bff/*를 사용합니다. 파트너·VMS·ITSM 연동은 반드시 /v1만 사용하세요.