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集成更加简单。

JavaScript / TypeScript

npm install @smoothq/sdk

Python

pip install smoothq

想要获取API密钥吗？

可从免费计划开始。请联系我们。

联系我们