📍 GPS API Documentation

โรงเรียนนรินุกูล - ระบบ API สำหรับจัดการข้อมูล GPS

🔗 Base URL

https://gps.narinukun.ac.th/api.php

🔑 API Key

narinukun_gps_2026

ส่งใน Header: X-API-Key หรือ Parameter: api_key

📋 API Endpoints

POST บันทึกข้อมูล GPS

api.php?action=save

Parameters (JSON):

{
    "user_id": "123456",
    "latitude": 15.244250,
    "longitude": 104.847000,
    "accuracy": 20.5,
    "timestamp": "2026-02-01 08:30:00",
    "reference_type": "time_attendance",
    "reference_id": 1,
    "device_info": {
        "platform": "iOS",
        "version": "15.0"
    }
}

GET ดึงข้อมูล GPS

api.php?action=get&user_id=123456&date=2026-02-01

Parameters:

user_id - รหัสผู้ใช้งาน (optional)
date - วันที่ (YYYY-MM-DD) (optional)
reference_type - ประเภทการอ้างอิง (optional)
reference_id - ID อ้างอิง (optional)
limit - จำนวนข้อมูล (default: 100) (optional)

GET ตรวจสอบพิกัด GPS

api.php?action=verify&latitude=15.244250&longitude=104.847000

Parameters:

latitude - ละติจูด (required)
longitude - ลองติจูด (required)

GET ทดสอบการเชื่อมต่อ

api.php?action=ping

ใช้สำหรับทดสอบว่า API ทำงานปกติ

💡 ตัวอย่างการเรียกใช้

JavaScript (Fetch API)

// บันทึกข้อมูล GPS
fetch('https://gps.narinukun.ac.th/api.php?action=save', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-API-Key': 'narinukun_gps_2026'
    },
    body: JSON.stringify({
        user_id: '123456',
        latitude: 15.244250,
        longitude: 104.847000,
        accuracy: 20.5,
        timestamp: '2026-02-01 08:30:00'
    })
})
.then(response => response.json())
.then(data => console.log(data));

PHP (cURL)

// ดึงข้อมูล GPS
$url = 'https://gps.narinukun.ac.th/api.php?action=get&user_id=123456';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: narinukun_gps_2026'
]);
$response = curl_exec($ch);
$data = json_decode($response, true);

⚠️ Response Format

{
    "success": true,
    "message": "GPS data saved successfully",
    "data": {
        "id": 1,
        "user_id": "123456",
        "latitude": "15.24425000",
        "longitude": "104.84700000",
        "timestamp": "2026-02-01 08:30:00"
    },
    "timestamp": "2026-02-01 08:30:15"
}