คู่มือ GoldPrice88 API v2

เริ่มใช้งานใน 3 ขั้นตอน

1. สมัครด้วยอีเมลและชื่อเว็บไซต์ โดยไม่ต้องใส่ https://
2. ยืนยันอีเมลและความเป็นเจ้าของเว็บไซต์ผ่าน DNS TXT, HTML file หรือ Meta Tag
3. คัดลอก API Key ที่แสดงเพียงครั้งเดียวและเก็บใน Environment/Secret ของระบบ

สมัครรับ API Key เข้าสู่ Dashboard

Authentication

ส่ง Key ด้วย HTTP Header ทุกครั้ง แนะนำ Authorization: Bearer และรองรับ X-GP88-Key สำหรับระบบที่ตั้ง Authorization Header ไม่ได้ ไม่รองรับ Key ใน Query String เพราะ URL อาจถูกบันทึกใน Log, Analytics และ Referrer

curl https://goldprice88.com/api/v2/gold/current \
  -H "Authorization: Bearer gp88_live_xxx_your_secret"

GET /api/v2/gold/current

ราคาทองล่าสุด พร้อมวันที่ เวลา รอบประกาศ ทองคำแท่ง ทองรูปพรรณ การเปลี่ยนแปลง สถิติระหว่างวัน Gold Spot ค่าเงินบาท ประวัติรอบ และ URL อ้างอิง

• Quota cost: 1 unit
• Cache: สูงสุด 15 วินาที
• รองรับ ETag และ If-None-Match

GET /api/v2/gold/daily

ข้อมูลราคาทองของวันเดียว ระบุ ?date=YYYY-MM-DD เช่น /api/v2/gold/daily?date=2026-08-08

• Quota cost: 2 units
• เรียกได้ตั้งแต่วันเดียวกันของปีก่อนจนถึงวันที่ปัจจุบัน รวมวันขอบเขต
• วันที่ผิดรูปแบบตอบ 400 invalid_date
• วันที่เกินช่วง 1 ปีหรือเป็นอนาคตตอบ 400 date_out_of_range พร้อม earliest_date และ latest_date
• ไม่มีข้อมูลตอบ 404

GET /api/v2/gold/history

สรุปราคาย้อนหลังรายวัน ระบุ ?period=7d, 30d หรือ 1y แต่ละรายการมีราคาเปิด ปิด สูงสุด ต่ำสุด การเปลี่ยนแปลง และจำนวนรอบประกาศ

• Quota cost: 5 units
• ช่วงสูงสุดคือ 1 ปีย้อนหลังแบบ rolling calendar year นับจากวันที่ปัจจุบัน
• Response ระบุ earliest_date, latest_date และ max_history: 1_year
• รองรับ ETag

ตัวอย่าง PHP

<?php
$ch = curl_init('https://goldprice88.com/api/v2/gold/current');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('GP88_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

เก็บ Key ใน Environment variable ไม่เขียน Key จริงลง Source Code หรือ Git repository

ตัวอย่าง JavaScript และ Node.js

Browser

const response = await fetch('https://goldprice88.com/api/v2/gold/current', {
  headers: { Authorization: `Bearer ${YOUR_API_KEY}` }
});
const payload = await response.json();

Node.js / Server

const response = await fetch('https://goldprice88.com/api/v2/gold/current', {
  headers: { Authorization: `Bearer ${process.env.GP88_API_KEY}` }
});
console.log(await response.json());

Key ที่ใช้ใน Browser สามารถถูกมองเห็นได้ จึงแนะนำให้เรียกผ่าน Backend ของเว็บไซต์เมื่อทำได้

Rate Limit และการดึงข้อมูลอย่างเหมาะสม

• ค่าเริ่มต้น 60 Requests ต่อนาที และ 10,000 Quota units ต่อวัน
• แนะนำ Poll ไม่ถี่กว่า 60 วินาที
• อ่าน RateLimit-Limit, RateLimit-Remaining และ RateLimit-Reset จาก Response Header
• เมื่อได้ 429 ให้รอตาม Retry-After และใช้ Exponential backoff

Response แบบ 304 ช่วยลด Bandwidth และภาระประมวลผล แม้ยังนับเป็น Request ตามโควตา

CORS และเว็บไซต์ที่ลงทะเบียน

คำขอจาก Browser ต้องมี Origin ตรงกับเว็บไซต์ที่ยืนยันไว้ ระบบรองรับโดเมนหลักและ canonical www หลัง normalize ส่วน Server-to-Server อาจไม่มี Origin และจะถูกแสดงเป็น not_supplied ในสถิติ

Origin/Referer สามารถปลอมได้ในคำขอฝั่ง Server จึงไม่ใช่หลักฐานเชิงเข้ารหัส หากต้องการความเข้มงวดสูงควรเก็บ Key ใน Backend และติดต่อเพื่อกำหนด IP allowlist

Error response

ข้อผิดพลาดใช้ JSON รูปแบบคงที่ เช่น missing_or_invalid_key, invalid_key, key_inactive, origin_not_allowed, rate_limited, invalid_date, date_out_of_range และ not_found พร้อม HTTP status ที่สอดคล้อง

{\n  "status": "error",\n  "error": {"code": "date_out_of_range", "message": "..."},\n  "meta": {"earliest_date": "2025-08-08", "latest_date": "2026-08-08"}\n}

ข้อมูล ราคา และข้อจำกัด

ข้อมูลอ้างอิงประกาศของสมาคมค้าทองคำและระเบียนที่ GoldPrice88 ตรวจสอบได้ ไม่ใช่ใบเสนอราคา คำแนะนำซื้อขาย หรือ SLA ทางการเงิน ควรตรวจสอบราคากับผู้ประกอบการก่อนทำรายการ

เมื่อนำไปเผยแพร่ กรุณาระบุ GoldPrice88 และคงชื่อ/URL แหล่งอ้างอิงที่อยู่ใน Response อ่าน วิธีจัดเก็บข้อมูล, ข้อกำหนด และ ความเป็นส่วนตัว