Business Day Pilot

All in one businees day public holilday, bank day, calculator

原始信息汇总

Business Day Pilot API 数据集概述

基本信息

• 数据集名称: Business Day Pilot
• 提供商: Pilot DevLabs
• 类别: Business Software
• API版本: 1.0.0
• 内容类型: application/json
• 状态: Freemium
• 订阅者数量: 1

定价方案

• BASIC: $0.00 / mo
• PRO: $4.99 / mo
• ULTRA: $9.99 / mo
• MEGA: $19.99 / mo

性能指标

• 流行度: 8.9
• 服务等级: 100%
• 延迟: 405ms

核心功能

该API是一个全面的商业日计算器，支持100多个国家，具备节假日感知功能。主要功能包括：

• 计算指定日期范围内的商业日数量
• 为指定日期添加商业日
• 添加工作时间（支持自定义工作时间）
• 检查特定日期是否为商业日
• 查找下一个/上一个商业日
• 获取完整日期信息（节假日、周末、商业日）
• 列出指定范围内的所有非工作日
• 按国家和年份获取节假日列表
• 列出支持的国家及其区域

认证方式

• RapidAPI处理认证
• 消费者需在X-RapidAPI-Key头部提供其RapidAPI API密钥
• 健康端点（GET /v1/health）无需认证

响应格式

所有端点返回一致的JSON包装器： json { "success": true, "data": { ... }, "meta": { "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "timestamp": "2026-04-04T10:30:00Z", "version": "1.0.0" } }

错误响应

json { "success": false, "error": { "code": "INVALID_DATE_RANGE", "message": "end_date must be after start_date" } }

错误代码

代码	HTTP状态	描述
INVALID_DATE_RANGE	400	end_date在start_date之前
INVALID_DATE_FORMAT	400	日期格式不是YYYY-MM-DD
INVALID_COUNTRY_CODE	400	未知的ISO 3166-1 alpha-2国家代码
INVALID_HOLIDAY_MODE	400	未知的节假日模式值
AUTHENTICATION_FAILED	401	缺少或无效的代理密钥
RATE_LIMIT_EXCEEDED	429	请求过多
INTERNAL_ERROR	500	意外的服务器错误

端点列表

1. 健康检查

• 端点: GET /v1/health
• 描述: 返回API健康状态，无需认证
• 响应: json { "status": "ok", "version": "1.0.0" }

2. 计算商业日数量

• 端点: POST /v1/calculate/business-days
• 描述: 计算日期范围内的商业日数量（排除周末和节假日）

3. 添加商业日

• 端点: POST /v1/calculate/add-business-days
• 描述: 将指定日期向前推进指定数量的商业日

4. 添加工作时间

• 端点: POST /v1/calculate/add-working-hours
• 描述: 为日期时间添加工作时间，考虑工作时间、周末和节假日

5. 是否为商业日

• 端点: POST /v1/calculate/is-business-day
• 描述: 检查特定日期是否为商业日

6. 下一个商业日

• 端点: POST /v1/calculate/next-business-day
• 描述: 从起始日期查找下一个或上一个商业日

7. 获取日期信息

• 端点: POST /v1/calculate/get-day-info
• 描述: 获取特定日期的完整信息

8. 列出非工作日

• 端点: POST /v1/calculate/list-non-working
• 描述: 列出日期范围内的所有非工作日（周末和节假日）

9. 列出节假日

• 端点: GET /v1/holidays
• 描述: 获取国家和年份的所有公共节假日

10. 列出国家

• 端点: GET /v1/countries
• 描述: 获取所有支持国家的列表

11. 列出区域

• 端点: GET /v1/countries/{country_code}/regions
• 描述: 获取具有区域节假日的国家的所有区域/细分

支持的国家

API通过holidays Python库支持100多个国家。常见国家代码包括：

代码	国家
DE	Germany
US	United States
GB	United Kingdom
FR	France
ES	Spain
IT	Italy
NL	Netherlands
BE	Belgium
AT	Austria
CH	Switzerland
CA	Canada
AU	Australia
JP	Japan
CN	China
IN	India
BR	Brazil
MX	Mexico

代码示例

提供了cURL、Python和JavaScript/Node.js的代码示例，演示如何使用API计算商业日数量。