Developer 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 기반 안전 관리 기능을 통합하고, 건설 현장의 안전성을 혁신적으로 향상시키세요.