thai

sidebar_position: 1 description: "获取泰国公共假日和重要日期数据"

🏖️ 泰国节假日数据 API

🏖️ 泰国节假日数据

0.1 IC每次请求

✅ 活跃📊 数据

欢迎使用泰国节假日数据 API，版本 1.0，这是由艾艾普科技有限公司开发的数据服务。我们的 API 提供来自多个权威来源的全面且最新的泰国节假日信息。通过快速的响应时间和可靠的服务，获取适用于金融机构和泰国公共假期的准确节假日数据。

试用演示

Example Queries (Click to try)

?holiday_type=public&days_after=30

获取未来 30 天的公共假期

?holiday_type=financial&days_after=90

获取未来 90 天的金融机构假期

?holiday_type=both&year=2025

获取 2025 年的所有假期 (公共和金融)

?holiday_type=public&start_date=2025-07-01&end_date=2025-12-31

获取 2025 年 7 月至 12 月的公共假期

API Key

Endpoint URL

Query Parameters

Add query parameters (e.g., ?holiday_type=public&days_after=30)

cURL Command

入门指南

先决条件
- 来自艾艾普科技的 API 密钥
- HTTP 客户端或您选择的编程语言
- 对 REST API 原理的理解
快速入门
- 快速响应时间 (通常在 500ms 以内)
- 实时节假日数据更新
- 支持多种节假日类型
- 灵活的日期范围查询
主要功能
- 金融假期: 泰国银行的泰国金融机构假期
- 公共假期: 内阁秘书处的泰国公共假期
- 合并数据: 在一次请求中访问两种类型
- 灵活的日期范围查询 (几天前/后，特定年份，自定义范围)
- 泰语和英语假期名称
- 两种语言的星期信息
数据新鲜度
- 我们的泰国团队会定期监控并立即更新节假日数据，一旦在泰国宣布新的假期
- 数据已缓存以获得最佳性能，同时确保准确性

如何获取 API 密钥？

请访问 API 密钥管理页面查看您现有的 API 密钥或申请新密钥。

API 端点

端点	方法	描述	费用
`/v3/store/data/thai-holiday` 旧版: `/data/thai-holidays/holidays`	GET	检索泰国公共和金融假期	每请求 0.1 IC

示例

获取当年公共假期

请求:

curl -X GET "https://api.iapp.co.th/v3/store/data/thai-holiday?holiday_type=public&days_after=365" \
    -H "apikey: YOUR_API_KEY"

响应:

{
    "holidays": [
        {
            "date": "2025-07-10",
            "date_thai": null,
            "weekday": "Thursday",
            "weekday_thai": null,
            "name": "วันอาสาฬหบูชา",
            "name_thai": null,
            "type": "public"
        },
        {
            "date": "2025-07-28",
            "date_thai": null,
            "weekday": "Monday",
            "weekday_thai": null,
            "name": "วันเฉลิมพระชนมพรรษา สมเด็จพระเจ้าอยู่หัวมหาวชิราลงกรณ บดินทรเทพยวรางกูร",
            "name_thai": null,
            "type": "public"
        }
    ],
    "total_count": 25,
    "date_range": {
        "start_date": "2025-06-08",
        "end_date": "2026-06-08",
        "query_type": "range",
        "reference_date": "2025-06-08"
    },
    "holiday_types": ["public"],
    "cached_at": "2025-06-08T10:29:33.740056"
}

获取特定年份的假期

请求:

curl -X GET "https://api.iapp.co.th/v3/store/data/thai-holiday/year/2025?holiday_type=both" \
    -H "apikey: YOUR_API_KEY"

获取日期范围内的假期

请求:

curl -X GET "https://api.iapp.co.th/v3/store/data/thai-holiday/range?start_date=2025-01-01&end_date=2025-12-31&holiday_type=financial" \
    -H "apikey: YOUR_API_KEY"

功能和能力

假期类型

我们的 API 支持三种类型的节假日数据：

公共假期

来源: 内阁秘书处 (由艾艾普科技团队维护)
描述: วันหยุดนักขัตฤกษ์ (泰国公共假期)
包括: 国家节假日、皇家仪式、宗教节日

金融假期

来源: 泰国银行 (由艾艾普科技团队维护)
描述: วันหยุดตามประเพณีของสถาบันการเงิน (泰国金融机构假期)
包括: 银行假期、金融行业休假

两者兼有

来源: 从两个来源合并
描述: 单一响应中的所有假期类型
用例: 全面的节假日规划

查询选项

日期范围: 按今天之前的/之后的几天、特定年份或自定义日期范围查询
灵活参数: 指定所需时间段的多种方法
类型过滤: 只获取与您的用例相关的假期类型

数据质量

实时更新: 一旦宣布假期，数据将立即更新
权威来源: 数据来源于泰国官方政府 API 和经过验证的日历
双语支持: 假期名称和星期几提供泰语和英语 (如适用)

API 参考

基本 URL

https://api.iapp.co.th/v3/store/data/thai-holiday

认证

所有请求都需要在标头中提供 API 密钥：

apikey: YOUR_API_KEY

端点

获取泰国假期

GET /holidays

返回指定时间段内的泰国假期。

查询参数

参数	类型	是否必需	默认值	描述
days_before	integer	否	0	今天之前的日数 (最大: 1825)
days_after	integer	否	365	今天之后的日数 (最大: 1825)
holiday_type	string	否	"public"	类型: "financial", "public", 或 "both"
year	integer	否	null	特定年份 (2020-2030，覆盖 days_before/after)

按年份获取假期

GET /holidays/year/\{year\}

返回特定年份的所有假期。

路径参数

参数	类型	是否必需	描述
year	integer	是	查询年份 (2020-2030)

查询参数

参数	类型	是否必需	默认值	描述
holiday_type	string	否	"public"	类型: "financial", "public", 或 "both"

按日期范围获取假期

GET /holidays/range

返回特定日期范围内的假期。

查询参数

参数	类型	是否必需	描述
start_date	string (date)	是	开始日期 (YYYY-MM-DD 格式)
end_date	string (date)	是	结束日期 (YYYY-MM-DD 格式)
holiday_type	string	否	类型: "financial", "public", 或 "both"

获取假期类型

GET /holidays/types

返回有关可用假期类型的信息。

响应格式

假期对象

{
    "date": "2025-07-10",
    "date_thai": null,
    "weekday": "Thursday",
    "weekday_thai": null,
    "name": "วันอาสาฬหบูชา",
    "name_thai": null,
    "type": "public"
}

响应字段

字段	类型	描述
date	string (date)	假期的日期，YYYY-MM-DD 格式
date_thai	string/null	假期的泰语格式日期
weekday	string	星期几 (英语)
weekday_thai	string/null	星期几 (泰语)
name	string	假期的名称
name_thai	string/null	假期的泰语名称
type	string	假期类型 ("public" 或 "financial")

列表响应

{
    "holidays": [/* 假期对象 */],
    "total_count": 25,
    "date_range": {
        "start_date": "2025-06-08",
        "end_date": "2026-06-08",
        "query_type": "range",
        "reference_date": "2025-06-08"
    },
    "holiday_types": ["public"],
    "cached_at": "2025-06-08T10:29:33.740056"
}

错误代码

HTTP 状态码

状态码	描述
200	成功
400	错误请求 - 参数无效
401	未授权 - API 密钥无效或缺失
404	未找到 - 端点无效
422	验证错误 - 参数验证失败
429	请求过多 - 速率限制已超出
500	内部服务器错误

验证错误

无效日期范围

{
    "detail": [
        {
            "loc": ["query", "start_date"],
            "msg": "无效日期格式。请使用 YYYY-MM-DD",
            "type": "value_error"
        }
    ]
}

无效的假期类型

{
    "detail": [
        {
            "loc": ["query", "holiday_type"],
            "msg": "假期类型必须是 'financial', 'public', 或 'both'",
            "type": "value_error"
        }
    ]
}

代码示例

Curl

curl -X GET "https://api.iapp.co.th/v3/store/data/thai-holiday?year=2025" \
    -H "apikey: YOUR_API_KEY"

Python

import requests

url = "https://api.iapp.co.th/v3/store/data/thai-holiday"

params = {
    'holiday_type': 'public',
    'days_after': 90
}

headers = {
    'apikey': 'YOUR_API_KEY'
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

print(f"找到 {data['total_count']} 个假期")
for holiday in data['holidays']:
    print(f"{holiday['date']}: {holiday['name']}")

JavaScript

const axios = require('axios');

const config = {
    method: 'get',
    url: 'https://api.iapp.co.th/v3/store/data/thai-holiday',
    headers: {
        'apikey': 'YOUR_API_KEY'
    },
    params: {
        holiday_type: 'both',
        year: 2025
    }
};

axios(config)
    .then((response) => {
        console.log(`找到 ${response.data.total_count} 个假期`);
        response.data.holidays.forEach(holiday => {
            console.log(`${holiday.date}: ${holiday.name}`);
        });
    })
    .catch((error) => console.log(error));

PHP

<?php
$curl = curl_init();

$url = 'https://api.iapp.co.th/v3/store/data/thai-holiday?' .
       http_build_query([
           'holiday_type' => 'public',
           'days_after' => 180
       ]);

curl_setopt_array($curl, array(
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => array(
        'apikey: YOUR_API_KEY'
    ),
));

$response = curl_exec($curl);
curl_close($curl);

$data = json_decode($response, true);
echo "找到 " . $data['total_count'] . " 个假期\n";

foreach ($data['holidays'] as $holiday) {
    echo $holiday['date'] . ": " . $holiday['name'] . "\n";
}
?>

Swift

import Foundation

let headers = [
    "apikey": "YOUR_API_KEY"
]

var components = URLComponents(string: "https://api.iapp.co.th/v3/store/data/thai-holiday")!
components.queryItems = [
    URLQueryItem(name: "holiday_type", value: "financial"),
    URLQueryItem(name: "year", value: "2025")
]

var request = URLRequest(url: components.url!, timeoutInterval: Double.infinity)
request.addValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    guard let data = data else {
        print(String(describing: error))
        return
    }

    do {
        let json = try JSONSerialization.jsonObject(with: data, options: [])
        print(json)
    } catch {
        print(error)
    }
}

task.resume()

Kotlin

import okhttp3.*
import java.io.IOException

val client = OkHttpClient()

val url = HttpUrl.Builder()
    .scheme("https")
    .host("api.iapp.co.th")
    .addPathSegments("data/thai-holidays/holidays")
    .addQueryParameter("holiday_type", "both")
    .addQueryParameter("days_after", "365")
    .build()

val request = Request.Builder()
    .url(url)
    .addHeader("apikey", "YOUR_API_KEY")
    .build()

client.newCall(request).execute().use { response ->
    if (!response.isSuccessful) throw IOException("Unexpected code $response")

    println(response.body()?.string())
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ThaiHolidayAPI {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        String url = "https://api.iapp.co.th/v3/store/data/thai-holiday" +
                    "?holiday_type=public&days_after=90";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("apikey", "YOUR_API_KEY")
            .GET()
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

Dart

import 'package:http/http.dart' as http;
import 'dart:convert';

void main() async {
    final uri = Uri.parse('https://api.iapp.co.th/v3/store/data/thai-holiday')
        .replace(queryParameters: {
            'holiday_type': 'public',
            'year': '2025'
        });

    final response = await http.get(
        uri,
        headers: {
            'apikey': 'YOUR_API_KEY'
        }
    );

    if (response.statusCode == 200) {
        final data = json.decode(response.body);
        print('找到 ${data['total_count']} 个假期');

        for (var holiday in data['holidays']) {
            print('${holiday['date']}: ${holiday['name']}');
        }
    } else {
        print('错误: ${response.statusCode}');
    }
}

最佳实践

错误处理

检查 HTTP 状态码: 始终验证响应状态
解析错误消息: 使用详细的错误信息进行调试
实现备用方案: 在 API 不可用时制定备用计划
记录 API 调用: 监控您的使用模式和错误

性能提示

批量请求: 获取更长时间段的数据，而不是多次小请求
使用年份端点: 获取全年数据时，请使用专用的年份端点
监控响应时间: 跟踪应用程序中的 API 性能

用例

业务应用

薪资系统: 计算工作日和假日工资
金融服务: 确定交易日和结算日期
电子商务: 围绕假期计划促销活动
调度系统: 避免在假期安排会议

开发集成

日历应用程序: 在日历视图中显示泰国节假日
商业智能: 在分析中包含节假日数据
通知系统: 发送节日祝福和提醒
移动应用: 显示相关的节假日信息

数据来源和准确性

主要来源

泰国银行: 官方金融机构假期
政府公告: 泰国当局的实时更新

更新流程

我们的专属泰国团队监控官方渠道，并在以下情况下立即更新假期数据：

政府宣布新的假期
现有假期被修改或取消
宣布了特别的临时假期

数据验证

所有假期数据都经过验证检查，以确保：

日期准确性和格式
正确的分类 (公共 vs 金融)
一致的命名约定
必需字段的完整性

定价

API 服务名称	端点	每请求 IC
泰国节假日数据 API (v1.0)	/holidays	0.1 IC/请求
	/holidays/year/{year}	0.1 IC/请求
	/holidays/range	0.1 IC/请求
	/holidays/types	0.1 IC/请求

速率限制

默认: 每小时每 API 密钥 1000 个请求
爆发: 每分钟最多 100 个请求
企业版: 可提供自定义限制

如有需要，请联系我们的团队以获得更高的速率限制。

支持与维护

数据更新

我们的泰国团队通过以下方式确保节假日数据始终最新：

24/7 监控政府公告
在官方公告发布后几小时内更新 API
跨多个来源验证数据准确性

API 可靠性

正常运行时间: 99.9% SLA
响应时间: 平均 < 50ms
地理分布: 从多个地区提供服务以获得最佳性能

获取帮助

文档: 本综合指南
API 门户: https://iapp.co.th 用于账户管理
支持: 通过 API 门户联系我们的团队
状态页面: 监控 API 健康和公告

sidebar_position: 1 description: "获取泰国公共假日和重要日期数据"​

🏖️ 泰国节假日数据 API

试用演示​

Example Queries (Click to try)

入门指南​

API 端点​

示例​

获取当年公共假期​

请求:​

响应:​

获取特定年份的假期​

请求:​

获取日期范围内的假期​

请求:​

功能和能力​

假期类型​

公共假期​

金融假期​

两者兼有​

查询选项​

数据质量​

API 参考​

基本 URL​

认证​

端点​

获取泰国假期​

查询参数​

按年份获取假期​

路径参数​

查询参数​

按日期范围获取假期​

查询参数​

获取假期类型​

响应格式​

假期对象​

响应字段​

列表响应​

错误代码​

HTTP 状态码​

验证错误​

无效日期范围​

无效的假期类型​

代码示例​

Curl​

Python​

JavaScript​

PHP​

Swift​

Kotlin​

Java​

Dart​

最佳实践​

错误处理​

性能提示​

用例​

业务应用​

开发集成​

数据来源和准确性​

主要来源​

更新流程​

数据验证​

定价​

速率限制​

支持与维护​

数据更新​

API 可靠性​

获取帮助​

sidebar_position: 1 description: "获取泰国公共假日和重要日期数据"

试用演示

入门指南

API 端点

示例

获取当年公共假期

请求:

响应:

获取特定年份的假期

请求:

获取日期范围内的假期

请求:

功能和能力

假期类型

公共假期

金融假期

两者兼有

查询选项

数据质量

API 参考

基本 URL

认证

端点

获取泰国假期

查询参数

按年份获取假期

路径参数

查询参数

按日期范围获取假期

查询参数

获取假期类型

响应格式

假期对象

响应字段

列表响应

错误代码

HTTP 状态码

验证错误

无效日期范围

无效的假期类型

代码示例

Curl

Python

JavaScript

PHP

Swift

Kotlin

Java

Dart

最佳实践

错误处理

性能提示

用例

业务应用

开发集成

数据来源和准确性

主要来源

更新流程

数据验证

定价

速率限制

支持与维护

数据更新

API 可靠性

获取帮助