Smart Scheduler

Build field-service schedules with time windows, worker eligibility, directed travel, breaks, depots, linked visits and multi-worker appointments.

原始信息汇总

Smart Scheduler API 数据集详情总结

基本信息

• API名称: Smart Scheduler
• 版本: 1.3.0（当前版本）
• 类别: Logistics（物流）
• 提供者: Jack Mccubbine
• 订阅人数: 1
• 服务等级: 100%
• 延迟: 5028ms
• 流行度: 9.2
• 产品网站: 见RapidAPI平台相关资源页面

核心功能

Smart Scheduler 是一个智能排程调度API，能够根据一个JSON请求构建工人路线和预约时间表。该API将工作分配给符合条件的员工，选择开始时间和访问顺序，并为每个工人返回按时间排序的时间线。

适用场景

• 现场服务、检查、维护、家庭拜访等移动劳动力管理场景
• 需要已具备定向行驶时间和行驶距离数据的应用

关键特性

建模规则

• 工人轮班、资格和劳动费率
• 预约时间窗口及强制或可选工作
• 非对称行驶时间和距离
• 工人出发和结束的车场（含车场服务时间）
• 周期性带薪或无薪休息
• 需要多个不同工人的预约
• 同步开始及相关访视之间的最小间隔
• 在不同地点开始和结束的预约

输出数据

• 每个工人的预约安排
• 完整的预约、行驶、等待、休息和车场服务间隔时间线
• 未分配的可选工作
• 保留的经济目标和搜索诊断信息

API端点

方法	端点	功能
GET	/health	返回服务存活状态、应用版本及当前计划容量
POST	/solve	验证并执行一次有界调度搜索

必需输入

解决请求需包含以下四个必需字段：

1. appointments — 工作内容、时间窗口、符合条件的工人和可选约束
2. staff — 工人轮班、成本、车场和休息规则
3. travel_time_min — 分钟为单位的嵌套有向矩阵
4. travel_km — 公里为单位的嵌套有向矩阵（与travel_time_min具有相同的非对角键）

订阅计划

计划	月费	逻辑预约数	扩展工作数	工人数	搜索时间	构建启动数
BASIC	$0.00	25	25	5	15秒	15
PRO	$50.00	50	50	15	30秒	20
ULTRA	$200.00	150	150	25	50秒	20
MEGA	$1,000.00	300	300	40	70秒	35

月度请求配额和速率限制在定价标签页中另有说明

响应状态解释

状态	含义
Feasible	找到满足所有强制硬性规则的完整候选方案（非最优性证明）
NoSolutionFound	有界搜索结束但未找到完整候选方案（非不可行性证明）
Infeasible	在启发式搜索前确认了结构性矛盾

注意：每次使用响应时，应先查看status和termination_reason字段，完整的可行响应中每个工人都会出现在routes中，包含紧凑预约路线、完整时间线、明确行驶段和休息信息。

HTTP错误代码

HTTP状态码	含义
400	跨字段调度数据或矩阵验证失败
403	调用未通过RapidAPI或超出验证计划容量
413	超过全局求解器安全限制
422	JSON请求体不符合声明模式
429	超出RapidAPI速率限制或配额
500	求解器意外错误（需附上X-Request-ID联系支持）
503	服务端RapidAPI来源凭证未配置

数据安全注意事项

• 请勿在预约ID、工人ID或其他请求字段中包含API密钥、凭据或不必要的敏感个人信息
• 该应用设计为不将请求体写入自身日志，但RapidAPI、Modal和网络基础设施可能根据其自身策略处理或保留请求和响应数据
• 报告问题时，请附上响应的X-Request-ID、X-Smart-Scheduler-Version、HTTP状态码及最小可复现请求（移除机密数据）