🏖️ ข้อมูลวันหยุดไทย

0.1 ICต่อคำขอ

v1.0 Active🆕 พ.ศ. 2568 GET /v3/store/data/thai-holiday

ยินดีต้อนรับสู่ Thai Holiday Data API เวอร์ชัน 1.0 ซึ่งเป็นบริการข้อมูลที่พัฒนาโดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด API ของเราให้ข้อมูลวันหยุดของไทยที่ครอบคลุมและเป็นปัจจุบันจากแหล่งข้อมูลที่น่าเชื่อถือหลายแห่ง รับข้อมูลวันหยุดที่ถูกต้องสำหรับสถาบันการเงินและวันหยุดนักขัตฤกษ์ในประเทศไทย ด้วยเวลาตอบสนองที่รวดเร็วและบริการที่เชื่อถือได้

Try Demo

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

API Key

Log in to use your API keys or Create an account

Endpoint URL

Query Parameters

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

cURL Command

Getting Started

1. Prerequisites

   • API key จาก ไอแอพพ์เทคโนโลยี
   • HTTP client หรือภาษาโปรแกรมที่คุณเลือก
   • ความเข้าใจเกี่ยวกับหลักการ REST API

2. Quick Start

   • เวลาตอบสนองที่รวดเร็ว (โดยทั่วไปต่ำกว่า 500ms)
   • การอัปเดตข้อมูลวันหยุดแบบเรียลไทม์
   • รองรับประเภทวันหยุดหลายประเภท
   • การค้นหาช่วงวันที่ที่ยืดหยุ่น

3. Key Features

   • วันหยุดสถาบันการเงิน: วันหยุดของสถาบันการเงินในประเทศไทยจากธนาคารแห่งประเทศไทย
   • วันหยุดนักขัตฤกษ์: วันหยุดนักขัตฤกษ์ของประเทศไทยจากสำนักเลขาธิการคณะรัฐมนตรี
   • ข้อมูลรวม: เข้าถึงทั้งสองประเภทในการเรียกใช้ครั้งเดียว
   • การค้นหาช่วงวันที่ที่ยืดหยุ่น (วันก่อน/หลัง, ปีที่ระบุ, ช่วงที่กำหนดเอง)
   • ชื่อวันหยุดภาษาไทยและภาษาอังกฤษ
   • ข้อมูลวันในสัปดาห์ทั้งสองภาษา

4. Data Freshness

   • ทีมงานของเราในประเทศไทยจะคอยตรวจสอบและอัปเดตข้อมูลวันหยุดอย่างสม่ำเสมอทันทีที่มีการประกาศวันหยุดใหม่ในประเทศไทย
   • ข้อมูลจะถูกแคชเพื่อประสิทธิภาพสูงสุด พร้อมทั้งรับประกันความถูกต้อง

วิธีรับ API Key?

กรุณาไปที่หน้า API Key Management เพื่อดู API key ที่มีอยู่ของคุณ หรือขอใหม่

API Endpoints

Endpoint	Method	Description	Cost
/v3/store/data/thai-holiday Legacy: /data/thai-holidays/holidays	GET	ดึงข้อมูลวันหยุดนักขัตฤกษ์และวันหยุดสถาบันการเงินของไทย	0.1 IC ต่อการเรียกใช้

Example

Get Current Year Public Holidays

Request:

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

Response:

{
    "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"
}

Get Holidays for Specific Year

Request:

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

Get Holidays in Date Range

Request:

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"

Features & Capabilities

Holiday Types

API ของเราสนับสนุนข้อมูลวันหยุด 3 ประเภท:

Public Holidays

• Source: The Secretariat of Cabinet (ดูแลโดยทีม ไอแอพพ์เทคโนโลยี)
• Description: วันหยุดนักขัตฤกษ์
• Includes: วันหยุดประจำชาติ, พระราชพิธี, วันสำคัญทางศาสนา

Financial Holidays

• Source: Bank of Thailand (ดูแลโดยทีม ไอแอพพ์เทคโนโลยี)
• Description: วันหยุดตามประเพณีของสถาบันการเงิน
• Includes: วันหยุดธนาคาร, วันปิดทำการของภาคการเงิน

Both Types

• Source: รวมจากทั้งสองแหล่ง
• Description: วันหยุดทุกประเภทในการตอบสนองครั้งเดียว
• Use Case: การวางแผนวันหยุดที่ครอบคลุม

Query Options

• Date Ranges: ค้นหาตามวันก่อน/หลังวันนี้, ปีที่ระบุ, หรือช่วงวันที่กำหนดเอง
• Flexible Parameters: วิธีการระบุช่วงเวลาที่คุณต้องการหลายวิธี
• Type Filtering: รับเฉพาะประเภทวันหยุดที่เกี่ยวข้องกับกรณีการใช้งานของคุณ

Data Quality

• Real-time Updates: ข้อมูลวันหยุดจะได้รับการอัปเดตทันทีเมื่อมีการประกาศ
• Authoritative Sources: ข้อมูลได้มาจาก API ของรัฐบาลไทยอย่างเป็นทางการและปฏิทินที่ได้รับการตรวจสอบ
• Bilingual Support: ชื่อวันหยุดและวันในสัปดาห์มีทั้งภาษาไทยและภาษาอังกฤษเมื่อใช้ได้

API Reference

Base URL

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

Authentication

การเรียกใช้ทั้งหมดต้องใช้ API key ในส่วนหัว:

apikey: YOUR_API_KEY

Endpoints

Get Thai Holidays

GET /holidays

ส่งคืนวันหยุดของไทยในช่วงเวลาที่ระบุ

Query Parameters

Parameter	Type	Required	Default	Description
days_before	integer	No	0	จำนวนวันก่อนวันนี้ (สูงสุด: 1825)
days_after	integer	No	365	จำนวนวันหลังจากวันนี้ (สูงสุด: 1825)
holiday_type	string	No	"public"	ประเภท: "financial", "public", หรือ "both"
year	integer	No	null	ปีที่ระบุ (2020-2030, จะแทนที่ days_before/after)

Get Holidays by Year

GET /holidays/year/\{year\}

ส่งคืนวันหยุดทั้งหมดสำหรับปีที่ระบุ

Path Parameters

Parameter	Type	Required	Description
year	integer	Yes	ปีที่ต้องการค้นหา (2020-2030)

Query Parameters

Parameter	Type	Required	Default	Description
holiday_type	string	No	"public"	ประเภท: "financial", "public", หรือ "both"

Get Holidays by Date Range

GET /holidays/range

ส่งคืนวันหยุดในช่วงวันที่ที่ระบุ

Query Parameters

Parameter	Type	Required	Description
start_date	string (date)	Yes	วันที่เริ่มต้น (รูปแบบ YYYY-MM-DD)
end_date	string (date)	Yes	วันที่สิ้นสุด (รูปแบบ YYYY-MM-DD)
holiday_type	string	No	ประเภท: "financial", "public", หรือ "both"

Get Holiday Types

GET /holidays/types

ส่งคืนข้อมูลเกี่ยวกับประเภทวันหยุดที่มีให้

Response Format

Holiday Object

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

Response Fields

Field	Type	Description
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")

List Response

{
    "holidays": [/* Holiday objects */],
    "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"
}

Error Codes

HTTP Status Codes

Status Code	Description
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid or missing API key
404	Not Found - Invalid endpoint
422	Validation Error - Parameter validation failed
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

Validation Errors

Invalid Date Range

{
    "detail": [
        {
            "loc": ["query", "start_date"],
            "msg": "Invalid date format. Use YYYY-MM-DD",
            "type": "value_error"
        }
    ]
}

Invalid Holiday Type

{
    "detail": [
        {
            "loc": ["query", "holiday_type"], 
            "msg": "Holiday type must be 'financial', 'public', or 'both'",
            "type": "value_error"
        }
    ]
}

Code Examples

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"Found {data['total_count']} holidays")
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(`Found ${response.data.total_count} holidays`);
        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 "Found " . $data['total_count'] . " holidays\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('Found ${data['total_count']} holidays');
        
        for (var holiday in data['holidays']) {
            print('${holiday['date']}: ${holiday['name']}');
        }
    } else {
        print('Error: ${response.statusCode}');
    }
}

Best Practices

Error Handling

1. Check HTTP Status Codes: ตรวจสอบสถานะการตอบสนองเสมอ
2. Parse Error Messages: ใช้ข้อมูลข้อผิดพลาดโดยละเอียดเพื่อการดีบัก
3. Implement Fallbacks: มีแผนสำรองเมื่อ API ไม่พร้อมใช้งาน
4. Log API Calls: ตรวจสอบรูปแบบการใช้งานและข้อผิดพลาดของคุณ

Performance Tips

1. Batch Requests: ขอข้อมูลสำหรับช่วงเวลาที่ยาวขึ้นแทนการเรียกใช้หลายครั้ง
2. Use Year Endpoint: สำหรับข้อมูลทั้งปี ให้ใช้ endpoint ปีโดยเฉพาะ
3. Monitor Response Times: ติดตามประสิทธิภาพของ API ในแอปพลิเคชันของคุณ

Use Cases

Business Applications

• Payroll Systems: คำนวณวันทำงานและค่าตอบแทนวันหยุด
• Financial Services: กำหนดวันซื้อขายและวันชำระบัญชี
• E-commerce: วางแผนโปรโมชั่นในช่วงวันหยุด
• Scheduling Systems: หลีกเลี่ยงการจองการประชุมในวันหยุด

Development Integration

• Calendar Applications: แสดงวันหยุดของไทยในมุมมองปฏิทิน
• Business Intelligence: รวมข้อมูลวันหยุดในการวิเคราะห์
• Notification Systems: ส่งคำอวยพรและเตือนวันหยุด
• Mobile Apps: แสดงข้อมูลวันหยุดที่เกี่ยวข้อง

Data Sources and Accuracy

Primary Sources

• Bank of Thailand: วันหยุดสถาบันการเงินอย่างเป็นทางการ
• Government Announcements: การอัปเดตแบบเรียลไทม์จากหน่วยงานทางการไทย

Update Process

ทีมงานผู้เชี่ยวชาญของเราในประเทศไทยจะคอยติดตามช่องทางอย่างเป็นทางการและอัปเดตข้อมูลวันหยุดทันทีเมื่อ:

• มีการประกาศวันหยุดใหม่โดยรัฐบาล
• มีการเปลี่ยนแปลงหรือยกเลิกวันหยุดที่มีอยู่
• มีการประกาศวันหยุดพิเศษครั้งเดียว

Data Validation

ข้อมูลวันหยุดทั้งหมดจะผ่านการตรวจสอบเพื่อให้แน่ใจว่า:

• ความถูกต้องและรูปแบบของวันที่
• การจัดหมวดหมู่ที่ถูกต้อง (วันหยุดนักขัตฤกษ์ vs สถาบันการเงิน)
• ความสอดคล้องของชื่อ
• ความครบถ้วนของฟิลด์ที่จำเป็น

Pricing

API Service Name	Endpoint	IC Per Request
Thai Holiday Data API (v1.0)	/holidays	0.1 IC/Request
	/holidays/year/{year}	0.1 IC/Request
	/holidays/range	0.1 IC/Request
	/holidays/types	0.1 IC/Request

Rate Limits

• Default: 1000 requests ต่อชั่วโมง ต่อ API key
• Burst: สูงสุด 100 requests ต่อนาที
• Enterprise: มีกำหนดที่กำหนดเอง

ติดต่อทีมงานของเราสำหรับอัตราการจำกัดที่สูงขึ้นหากจำเป็นสำหรับแอปพลิเคชันของคุณ

Support and Maintenance

Data Updates

ทีมงานของเราในประเทศไทยรับประกันว่าข้อมูลวันหยุดจะทันสมัยอยู่เสมอโดย:

• การตรวจสอบประกาศของรัฐบาลตลอด 24 ชั่วโมงทุกวัน
• การอัปเดต API ภายในไม่กี่ชั่วโมงหลังจากการประกาศอย่างเป็นทางการ
• การตรวจสอบความถูกต้องของข้อมูลจากหลายแหล่ง

API Reliability

• Uptime: 99.9% SLA
• Response Time: < 50ms โดยเฉลี่ย
• Geographic: ให้บริการจากหลายภูมิภาคเพื่อประสิทธิภาพสูงสุด

Getting Help

• Documentation: คู่มือฉบับสมบูรณ์นี้
• API Portal: https://iapp.co.th สำหรับการจัดการบัญชี
• Support: ติดต่อทีมงานของเราผ่าน API portal
• Status Page: ตรวจสอบสถานะ API และประกาศ