Developer APISafe-on API
Safe-on API
개발자 문서
Safe-on의 강력한 AI 기반 안전 관리 기능을 여러분의 애플리케이션에 통합하세요. RESTful API를 통해 보고서 생성, 이미지 분석, 챗봇 기능을 쉽게 구현할 수 있습니다.
빠른 시작
// Safe-on JavaScript SDK
import { SafeOnClient } from '@safe-on/sdk';
const client = new SafeOnClient({
apiKey: 'your-api-key',
baseURL: 'https://api.safe-on.app'
});
// AI 보고서 생성
const report = await client.reports.generate({
title: '현장 안전점검',
description: '타워크레인 안전시설 점검',
image: 'https://example.com/site.jpg'
});
console.log(report);
API 엔드포인트
Safe-on 플랫폼의 핵심 기능을 API로 활용하세요
POST
/api/generate-ai-report
AI 보고서 생성
현장 이미지를 분석하여 안전 보고서를 자동 생성합니다.
파라미터
title
string필수
보고서 제목
description
string필수
현장 상황 설명
image
string
현장 이미지 URL
응답
stream마크다운 형식의 AI 생성 보고서 (스트리밍)
예시
{
"title": "건설 현장 안전점검 보고서",
"description": "타워크레인 주변 안전시설 점검",
"image": "https://example.com/site-image.jpg"
}
POST
/api/chat
AI 챗봇 대화
건설 안전 관련 질문에 대한 AI 답변을 제공합니다.
파라미터
message
string필수
사용자 질문
roomId
string필수
채팅방 ID
history
array
이전 대화 내역
응답
streamAI 답변 텍스트 (스트리밍)
예시
{
"message": "타워크레인 안전점검 항목이 무엇인가요?",
"roomId": "chat-room-123",
"history": []
}
GET
/api/documents
문서 목록 조회
사용자의 안전 보고서 목록을 조회합니다.
파라미터
page
number
페이지 번호 (기본값: 1)
limit
number
페이지당 항목 수 (기본값: 20)
type
string
문서 타입 필터 (ai, manual)
응답
json문서 목록과 페이지네이션 정보
예시
{
"documents": [
{
"id": "doc-123",
"title": "현장 안전점검 보고서",
"type": "ai",
"created_at": "2024-01-15T10:30:00Z",
"report_image": "https://example.com/image.jpg"
}
],
"total": 45,
"page": 1,
"limit": 20
}
POST
/api/upload
이미지 업로드
현장 이미지를 업로드하고 URL을 반환합니다.
파라미터
file
file필수
업로드할 이미지 파일
path
string
저장 경로 (기본값: reports/)
응답
json업로드된 이미지의 URL
예시
{
"url": "https://storage.example.com/reports/123-image.jpg",
"path": "reports/123-image.jpg",
"size": 2048576
}
인증 및 보안
API 키 인증
모든 API 요청에는 Authorization 헤더에 Bearer 토큰이 필요합니다.
Authorization: Bearer your-api-key
요청 제한
- • 분당 100회 요청 제한
- • 일일 10,000회 요청 제한
- • 파일 업로드: 최대 10MB
- • 응답 타임아웃: 30초
API로 더 스마트한 안전 관리를 시작하세요
Safe-on API를 활용하여 기존 시스템에 AI 기반 안전 관리 기능을 통합하고, 건설 현장의 안전성을 혁신적으로 향상시키세요.