장기요양시설 개방형 API 통합플랫폼
관리자
REST API v1.0

개방형 API

스마트 사회복지시설의 기기·장비 데이터를 표준화된 방식으로 연동하고,
상호운용성을 확보하는 개방형 REST API 서비스

인증키 발급

테스트/운영 서버용 API 인증키를 발급받으세요.

발급받기

SDK 다운로드

PHP, Python, Java, Ruby SDK를 다운로드하세요.

다운로드

API 테스트

Swagger UI에서 API를 직접 테스트해보세요.

테스트하기

운영서버 신청

운영 서버 사용 승인을 신청하세요.

신청하기
API CATEGORIES

API 카테고리

스마트 사회복지시설의 다양한 기기·장비 데이터를 위한 API 엔드포인트

이용자 모니터링

  • GET /api/v1/radar/presence
  • GET /api/v1/radar/activity
  • POST /api/v1/alerts/fall
  • POST /api/v1/alerts/absence

레이더 센서 기반 재실 감지, 활동량, 낙상·이상행동 알림

돌봄 부담 경감

  • GET /api/v1/diaper/status
  • POST /api/v1/diaper/alerts
  • GET /api/v1/mattress/pressure
  • GET /api/v1/laundry/tracking

스마트 기저귀, 욕창방지 매트리스, RFID 세탁물 관리

건강관리

  • GET /api/v1/meal/nutrition
  • POST /api/v1/medication/schedule
  • GET /api/v1/toilet/analysis
  • GET /api/v1/rehab/progress

스마트 식판, 스마트 약통, 스마트 변기, 재활보조로봇

공통 엔드포인트

Method Endpoint 설명 인증
POST /api/v1/auth/token 인증 토큰 발급 API Key
GET /api/v1/facilities 등록 시설 목록 조회 Bearer Token
GET /api/v1/devices 연동 기기 목록 조회 Bearer Token
GET /api/v1/residents 입소자 목록 조회 Bearer Token
POST /api/v1/data/sync 기기 데이터 동기화 Bearer Token
GET /api/v1/health API 서버 상태 확인 없음

인증 방식

모든 API 요청에는 인증이 필요합니다. Bearer Token 방식을 사용합니다.

# Request Header
Authorization: Bearer {your_token}

Rate Limit

API 요청 제한은 인증키 유형에 따라 다릅니다.

테스트 서버 1,000 요청/일
운영 서버 100,000 요청/일

응답 형식

성공 응답 

{
  "success": true,
  "data": {
    "id": "dev_123",
    "type": "radar_sensor",
    "status": "active",
    "last_sync": "2026-01-27T09:30:00Z"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-01-27T09:30:05Z"
  }
}

에러 응답 

{
  "success": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "인증 토큰이 만료되었습니다.",
    "details": "토큰을 재발급 받으세요."
  },
  "meta": {
    "request_id": "req_xyz789",
    "timestamp": "2026-01-27T09:31:00Z"
  }
}

지금 바로 API를 시작하세요

인증키를 발급받고 Swagger UI에서 API를 테스트해보세요.

인증키 발급 API 테스트