🎯 Thai Holiday Data API

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

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

ทดลองใช้งาน 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

Demo key is limited to 10 requests per day per IP
Click here to get your API key

Endpoint URL

Query Parameters

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

cURL Command

เริ่มต้นใช้งาน

1. ข้อกำหนดเบื้องต้น

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

2. เริ่มต้นอย่างรวดเร็ว

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

3. คุณสมบัติหลัก

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

4. ความสดใหม่ของข้อมูล

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

วิธีรับ API Key?

กรุณาเยี่ยมชม API Portal เพื่อดู API key ที่มีอยู่ของคุณหรือขอ API key ใหม่

ตัวอย่าง

รับวันหยุดราชการของปีปัจจุบัน

คำขอ:

curl -X GET "https://api.iapp.co.th/data/thai-holidays/holidays?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/data/thai-holidays/holidays/year/2025?holiday_type=both" \
    -H "apikey: YOUR_API_KEY"

รับวันหยุดในช่วงวันที่

คำขอ:

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

คุณสมบัติและความสามารถ

ประเภทของวันหยุด

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

วันหยุดราชการ

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

วันหยุดของสถาบันการเงิน

• แหล่งข้อมูล: ธนาคารแห่งประเทศไทย (ดูแลโดยทีมงาน ไอแอพพ์เทคโนโลยี)
• คำอธิบาย: วันหยุดตามประเพณีของสถาบันการเงิน (Thai Financial Institutions' Holidays)
• รวมถึง: วันหยุดธนาคาร การปิดทำการของภาคการเงิน

ทั้งสองประเภท

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

ตัวเลือกการค้นหา

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

คุณภาพของข้อมูล

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

ข้อมูลอ้างอิง API

URL พื้นฐาน

https://api.iapp.co.th/data/thai-holidays

การตรวจสอบสิทธิ์

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

apikey: YOUR_API_KEY

จุดสิ้นสุด

รับวันหยุดในประเทศไทย

GET /holidays

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

พารามิเตอร์การค้นหา

พารามิเตอร์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
days_before	จำนวนเต็ม	ไม่ใช่	0	จำนวนวันก่อนวันนี้ (สูงสุด: 1825)
days_after	จำนวนเต็ม	ไม่ใช่	365	จำนวนวันหลังจากวันนี้ (สูงสุด: 1825)
holiday_type	สตริง	ไม่ใช่	"public"	ประเภท: "financial", "public" หรือ "both"
year	จำนวนเต็ม	ไม่ใช่	null	ปีที่ระบุ (2020-2030, แทนที่ days_before/after)

รับวันหยุดตามปี

GET /holidays/year/\{year\}

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

พารามิเตอร์เส้นทาง

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
year	จำนวนเต็ม	ใช่	ปีที่จะค้นหา (2020-2030)

พารามิเตอร์การค้นหา

พารามิเตอร์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
holiday_type	สตริง	ไม่ใช่	"public"	ประเภท: "financial", "public" หรือ "both"

รับวันหยุดตามช่วงวันที่

GET /holidays/range

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

พารามิเตอร์การค้นหา

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
start_date	สตริง (วันที่)	ใช่	วันเริ่มต้น (รูปแบบ YYYY-MM-DD)
end_date	สตริง (วันที่)	ใช่	วันสิ้นสุด (รูปแบบ YYYY-MM-DD)
holiday_type	สตริง	ไม่ใช่	ประเภท: "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	สตริง (วันที่)	วันที่ของวันหยุดในรูปแบบ YYYY-MM-DD
date_thai	สตริง/null	วันที่ของวันหยุดในรูปแบบไทย
weekday	สตริง	วันในสัปดาห์เป็นภาษาอังกฤษ
weekday_thai	สตริง/null	วันในสัปดาห์เป็นภาษาไทย
name	สตริง	ชื่อวันหยุด
name_thai	สตริง/null	ชื่อวันหยุดเป็นภาษาไทย
type	สตริง	ประเภทวันหยุด ("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 key ไม่ถูกต้องหรือหายไป
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"
        }
    ]
}

ตัวอย่างโค้ด

Python

import requests

url = "https://api.iapp.co.th/data/thai-holidays/holidays"

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/data/thai-holidays/holidays',
    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/data/thai-holidays/holidays?' . 
       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/data/thai-holidays/holidays")!
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/data/thai-holidays/holidays" +
                    "?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/data/thai-holidays/holidays')
        .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('Error: ${response.statusCode}');
    }
}

แนวทางปฏิบัติที่ดีที่สุด

การจัดการข้อผิดพลาด

1. ตรวจสอบรหัสสถานะ HTTP: ตรวจสอบสถานะการตอบสนองเสมอ
2. แยกวิเคราะห์ข้อความแสดงข้อผิดพลาด: ใช้ข้อมูลข้อผิดพลาดโดยละเอียดสำหรับการแก้จุดบกพร่อง
3. ใช้การสำรอง: มีแผนสำรองสำหรับกรณีที่ API ไม่พร้อมใช้งาน
4. บันทึกการเรียกใช้ API: ตรวจสอบรูปแบบการใช้งานและข้อผิดพลาดของคุณ

เคล็ดลับด้านประสิทธิภาพ

1. การร้องขอแบบกลุ่ม: รับข้อมูลสำหรับช่วงเวลานานขึ้นแทนที่จะเป็นการร้องขอขนาดเล็กหลายครั้ง
2. ใช้จุดสิ้นสุดปี: สำหรับข้อมูลทั้งปี ให้ใช้จุดสิ้นสุดปีที่กำหนด
3. ตรวจสอบเวลาตอบสนอง: ติดตามประสิทธิภาพของ API ในแอปพลิเคชันของคุณ

กรณีใช้งาน

แอปพลิเคชันทางธุรกิจ

• ระบบการจ่ายเงินเดือน: คำนวณวันทำงานและค่าจ้างวันหยุด
• บริการทางการเงิน: กำหนดวันซื้อขายและวันตัดบัญชี
• อีคอมเมิร์ซ: วางแผนโปรโมชั่นในช่วงวันหยุด
• ระบบการจัดตาราง: หลีกเลี่ยงการจองการประชุมในวันหยุด

การรวมเข้ากับการพัฒนา

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

แหล่งข้อมูลและความถูกต้องของข้อมูล

แหล่งข้อมูลหลัก

• ธนาคารแห่งประเทศไทย: วันหยุดของสถาบันการเงินอย่างเป็นทางการ
• ประกาศของรัฐบาล: การอัปเดตแบบเรียลไทม์จากหน่วยงานของรัฐบาลไทย

กระบวนการอัปเดต

ทีมงานชาวไทยของเราตรวจสอบช่องทางอย่างเป็นทางการและอัปเดตข้อมูลวันหยุดทันทีเมื่อ:

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

การตรวจสอบความถูกต้องของข้อมูล

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

• ความถูกต้องและรูปแบบของวันที่
• การจัดประเภทที่ถูกต้อง (สาธารณะกับสถาบันการเงิน)
• ข้อตกลงในการตั้งชื่อที่สอดคล้องกัน
• ความสมบูรณ์ของฟิลด์ที่จำเป็น

ราคา

ชื่อบริการ API	จุดสิ้นสุด	IC ต่อการร้องขอ
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

ขีดจำกัดอัตรา

• ค่าเริ่มต้น: 1000 คำขอต่อชั่วโมงต่อ API key
• การระเบิด: สูงสุด 100 คำขอต่อนาที
• องค์กร: ขีดจำกัดที่กำหนดเอง

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

การสนับสนุนและการบำรุงรักษา

การอัปเดตข้อมูล

ทีมงานชาวไทยของเราทำให้แน่ใจว่าข้อมูลวันหยุดนั้นทันสมัยอยู่เสมอโดย:

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

ความน่าเชื่อถือของ API

• เวลาทำงาน: SLA 99.9%
• เวลาตอบสนอง: เฉลี่ย < 50ms
• ภูมิศาสตร์: ให้บริการจากหลายภูมิภาคเพื่อประสิทธิภาพที่ดีที่สุด

การขอความช่วยเหลือ

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