API 제공
SmoothQ의 대기시간 예측 데이터를 당신의 애플리케이션에 통합
개요
SmoothQ API는 전국 13만 이상 시설의 대기시간 예측 데이터에 프로그래매틱하게 접근하기 위한 RESTful API입니다. 시설 검색, 대기시간 예측, 혼잡 상황 취득 등 다양한 기능을 제공합니다.
# Base URL
https://api.smoothq.jp/v1
REST
RESTful 설계
JSON
JSON 형식
99.9%
가동률 보증
엔드포인트
GET/facilities
시설 목록을 취득합니다. 도도부현이나 시설 타입으로 필터링이 가능합니다.
파라미터
prefecture: string - 도도부현명으로 필터링
type: string - 시설 타입으로 필터링 (hospital, clinic, government 등)
limit: number - 취득 건수 (기본값: 20, 최대: 100)
offset: number - 오프셋 (페이지네이션용)
GET/facilities/{id}
지정한 ID의 시설 상세 정보를 취득합니다. 주소, 영업시간, 대응 서비스 등을 포함합니다.
GET/predictions/{facility_id}
지정한 시설의 대기시간 예측을 취득합니다. 현재 예측값, 시간대별 예측, 신뢰도 등을 포함합니다.
응답 예시
{
"facility_id": "tokyo_hospital_001",
"predicted_wait_time": 25,
"confidence": 0.85,
"congestion_level": "medium",
"prediction_tier": "verified",
"hourly_forecast": [...]
}GET/search
키워드나 위치 정보로 시설을 검색합니다.
파라미터
q: string - 검색 키워드
lat: number - 위도 (위치 검색용)
lng: number - 경도 (위치 검색용)
radius: number - 검색 반경 (미터, 기본값: 5000)
인증
API 접근에는 API 키가 필요합니다. 모든 요청의 Authorization 헤더에 API 키를 포함해 주세요.
# 요청 예시
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.smoothq.jp/v1/facilities
기업용 API 솔루션
SmoothQ API는 기업 및 사업자를 위해 완전 맞춤형 솔루션으로 제공됩니다. 귀사의 니즈에 맞는 최적의 플랜을 제안해 드립니다.
무료 지원
도입부터 운영까지 전담 스태프가 무료로 지원합니다.
전용 서버
보안과 성능을 극대화하는 전용 서버 환경을 제공합니다.
맞춤형 요금
이용 규모와 요건에 따라 최적의 요금 플랜을 제안합니다.
이용 방법
API 이용을 검토 중이시라면 문의 양식을 통해 연락해 주세요. 담당자가 영업일 기준 3일 이내에 연락드립니다.
SDK
주요 프로그래밍 언어용 SDK를 제공합니다. API 통합을 더 쉽게 수행할 수 있습니다.
JS
JavaScript / TypeScriptnpm install @smoothq/sdk
Py
Pythonpip install smoothq