ThaiSkyward
Developer API

ThaiSkyward Open API

เข้าถึงข้อมูลพยากรณ์อากาศความละเอียดสูงและข้อมูลย้อนหลังสำหรับพื้นที่จันทบุรี 4 อำเภอ ผ่าน RESTful API ที่ใช้งานง่าย รองรับการพัฒนาแอปพลิเคชันเกษตรและบริการต่างๆ

RESTful API

API ที่ออกแบบตามมาตรฐาน REST รองรับ JSON และใช้งานง่าย

ความละเอียดสูง

ข้อมูลพยากรณ์ระดับ Hyper-local (1-3 km) จาก ECMWF และ GFS

ปลอดภัย

ระบบ API Key Authentication และ Rate Limiting เพื่อความปลอดภัย

API Endpoints

GET/v1/weather/forecast

ดึงข้อมูลพยากรณ์อากาศล่วงหน้า 3-120 ชั่วโมง

Parameters

district
stringrequired

อำเภอที่ต้องการ: "เมือง", "มะขาม", "ขลุง", "ท่าใหม่"

source
stringoptional

แหล่งข้อมูล: "ECMWF" (default), "GFS"

hours
numberoptional

จำนวนชั่วโมงที่ต้องการ (3-120, default: 24)

ตัวอย่างการใช้งาน

curl -X GET "/v1/weather/forecast" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "district": "เมือง",
    "source": "ECMWF",
    "hours": 24
  }'

Response Format

ตัวอย่าง Response

รูปแบบการตอบกลับแบบ JSON พร้อมข้อมูลพยากรณ์อากาศแบบละเอียด

{
  "success": true,
  "data": {
    "district": "เมือง",
    "source": "ECMWF",
    "forecasts": [
      {
        "validTime": "2025-11-04T14:00:00Z",
        "metrics": {
          "temperature": {
            "value": 32.5,
            "unit": "°C",
            "label": "อุณหภูมิ"
          },
          "humidity": {
            "value": 75,
            "unit": "%",
            "label": "ความชื้น"
          },
          "rainfall": {
            "value": 2.3,
            "unit": "mm",
            "label": "ปริมาณฝน"
          },
          "windSpeed": {
            "value": 12.5,
            "unit": "km/h",
            "label": "ความเร็วลม"
          },
          "windDirection": {
            "value": 245,
            "unit": "°",
            "label": "ทิศทางลม"
          },
          "pressure": {
            "value": 1012.3,
            "unit": "hPa",
            "label": "ความกดอากาศ"
          },
          "cloudCover": {
            "value": 65,
            "unit": "%",
            "label": "เมฆปกคลุม"
          }
        }
      }
    ]
  },
  "timestamp": "2025-11-04T14:00:00Z",
  "cached": false
}

Authentication

API Key Authentication

การเข้าถึง API ทั้งหมดต้องใช้ API Key ในการยืนยันตัวตน โดยส่งผ่าน HTTP Header:

X-API-Key: your_api_key_here

API Key จะถูกออกให้หลังจากการยื่นคำขอและได้รับการอนุมัติจากทีมงาน

Rate Limits

200
requests / วัน
Standard Tier

หมายเหตุ: เมื่อเกิน Rate Limit จะได้รับ HTTP Status Code 429 (Too Many Requests)

ขอเข้าถึง API

สนใจใช้งาน ThaiSkyward API สำหรับโปรเจกต์ของคุณ? ติดต่อเราเพื่อขอรับ API Key และข้อมูลเพิ่มเติม

โปรดระบุรายละเอียดการใช้งาน, วัตถุประสงค์ของโปรเจกต์, และจำนวน API requests โดยประมาณที่ต้องการต่อเดือน