CAO 48.1 Compliance

Validate flight crew duty periods against Australian Civil Aviation Order 48.1 — a whole roster in a single call.

原始信息汇总

CAO 48.1 Compliance API 数据集概述

基本信息

• API名称: CAO 48.1 Compliance
• 提供商: JimmyBoon
• 订阅者数: 2
• 类别: Transportation
• 定价方案: BASIC ($0.00/月), PRO ($5.00/月), ULTRA ($25.00/月), MEGA ($99.00/月)

功能描述

该API是一个无状态REST API，用于验证飞行机组的飞行和执勤时间是否符合澳大利亚《Civil Aviation Order 48.1 Instrument 2019》（Compilation No. 3, F2021C01239）。覆盖全部九个附录——从基本的单飞行员限制到复杂的多飞行员增强操作、航空医疗、空中作业和飞行训练。输入排班表后，返回通过/失败结果，包含每项检查、每条违规记录及其对应的CAO 48.1条款引用和补救建议。

核心能力

• 验证范围: 飞行执勤期（FDP）、休息期（ODP）、累积限制
• 支持逻辑: 时间带查询、航段基数上限、WOCL（昼夜节律低谷窗口）和早起缩减、适应性和增强机组子表、分班执勤延长、机长裁量权、连续延长限制、最低休息期计算、滚动28/90/365天累积限制
• 设计特点: 由运营和机组调度员开发，参数语义、工作示例和常见错误反映了真实排班场景；专为AI集成设计，支持LLM/智能助手调用

覆盖附录

附录	操作类型
1	基本限制（单飞行员）
2	多飞行员，复杂飞机（WOCL + 增强机组）
3	多飞行员，非复杂飞机
4	任何操作
4A	气球操作
4B	医疗运输与紧急服务
5	空中作业及相关飞行训练
5A	日间空中作业
6	飞行训练

端点分类

健康与参考

方法	路径	说明
GET	/api/v1/cao481/health	状态和功能发现
GET	/api/v1/cao481/sections	CAO 48.1目录
GET	/api/v1/cao481/sections/{section_id}	特定章节或附录全文
GET	/api/v1/cao481/guide	自描述集成指南（从此处开始）

限制（参考数据）

方法	路径	说明
GET	/api/v1/cao481/limits/fdp-table/{appendix}	原始FDP查询表
GET	/api/v1/cao481/limits/cumulative/{appendix}	累积限制阈值

计算

方法	路径	说明
POST	/api/v1/cao481/calculate/max-fdp	计划执勤的最大允许FDP
POST	/api/v1/cao481/calculate/min-off-duty	最低所需休息期

验证

方法	路径	说明
POST	/api/v1/cao481/validate/fdp	验证单个FDP
POST	/api/v1/cao481/validate/off-duty	验证休息期
POST	/api/v1/cao481/validate/cumulative	检查滚动窗口累积限制
POST	/api/v1/cao481/validate/sequence	验证FDP/ODP序列（WOCL + 连续起飞规则）
POST	/api/v1/cao481/validate/roster	完整排班——一次调用检查所有FDP、ODP和休息日

关键概念与注意事项

• 时间使用本地时间而非UTC: FDP表查询依赖于出发站的本地时间，需提供本地偏移或本地开始时间
• API无状态: 请求间无会话记忆，累积窗口检查需在每次调用中传递过去的FDP历史
• WOCL判定由调用方负责: API不自动推导WOCL跨越，需调用方根据本地起止时间自行设置
• 所有时间戳使用UTC ISO 8601格式
• 验证响应始终包含顶层valid布尔值和violations列表，每条违规带有CAO 48.1条款引用和补救建议
• 计算与验证互补: 先计算限制值，再进行实际执勤验证

认证方式

通过RapidAPI代理，需提供两个请求头：

• X-RapidAPI-Key: RapidAPI应用密钥
• X-RapidAPI-Host: cao-48-1-compliance.p.rapidapi.com

重要声明

本API仅作为决策支持和参考工具，不替代运营商批准的疲劳管理手册、专业疲劳风险管理评估或监管审批。使用前请始终对照现行法规和运营商批准的程序进行验证。