Thai Holiday Data API

0.1 ICต่อการเรียกใช้

v1.0 ใช้งานได้ 2025 GET /v3/store/data/thai-holiday

ยินดีต้อนรับสู่ Thai Holiday Data 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

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

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

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

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

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

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

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

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

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

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

วิธีรับ API Key?

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

API Endpoints

Endpoint	Method	คำอธิบาย	ราคา
/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 ของเราสนับสนุนข้อมูลวันหยุด 3 ประเภท:

วันหยุดนักขัตฤกษ์

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

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

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

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

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

ตัวเลือกการสอบถาม

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

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

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

อ้างอิง API

URL พื้นฐาน

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

การยืนยันตัวตน

คำขอทั้งหมดต้องมี API Key ใน header:

apikey: YOUR_API_KEY

Endpoints

รับวันหยุดไทย

GET /holidays

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

Query Parameters

พารามิเตอร์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
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\}

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

Path Parameters

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

Query Parameters

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

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

GET /holidays/range

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

Query Parameters

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
start_date	string (date)	ใช่	วันที่เริ่มต้น (รูปแบบ YYYY-MM-DD)
end_date	string (date)	ใช่	วันที่สิ้นสุด (รูปแบบ YYYY-MM-DD)
holiday_type	string	ไม่	ประเภท: "financial", "public", หรือ "both"

รับประเภทวันหยุด

GET /holidays/types

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

รูปแบบการตอบสนอง

Holiday Object

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

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

รหัสข้อผิดพลาด

HTTP Status Codes

รหัสสถานะ	คำอธิบาย
200	สำเร็จ
400	คำขอไม่ถูกต้อง - พารามิเตอร์ไม่ถูกต้อง
401	ไม่ได้รับอนุญาต - API Key ไม่ถูกต้องหรือไม่พบ
404	ไม่พบ - Endpoint ไม่ถูกต้อง
422	ข้อผิดพลาดในการตรวจสอบความถูกต้อง - การตรวจสอบพารามิเตอร์ล้มเหลว
429	คำขอมากเกินไป - เกินขีดจำกัดอัตรา
500	ข้อผิดพลาดภายในเซิร์ฟเวอร์

Validation Errors

ช่วงวันที่ไม่ถูกต้อง

{
    "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}');
    }
}

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

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

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

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

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

กรณีใช้งาน

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

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

การรวมระบบพัฒนา

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

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

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

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

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

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

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

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

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

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

ราคา

ชื่อบริการ API	Endpoint	IC ต่อการเรียกใช้
Thai Holiday Data API (v1.0)	/holidays	0.1 IC/การเรียกใช้
	/holidays/year/{year}	0.1 IC/การเรียกใช้
	/holidays/range	0.1 IC/การเรียกใช้
	/holidays/types	0.1 IC/การเรียกใช้

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

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

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

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

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

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

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

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

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

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

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