ศูนย์ API

💡 แอปนี้คืออะไร

แอปในอาณาจักรพันธ์ทิพย์ทีวีเกือบทุกตัว "ไม่ได้ทำงานคนเดียว" — มันไปดึงข้อมูลจากที่อื่นมาอีกที เช่น ยอดขายมาจาก POS GebTang, สมอง AI มาจาก Gemini/Claude, แจ้งเตือนส่งผ่านบอท Telegram, ตำแหน่งรถมาจาก Cartrack, เว็บทุกตัวอยู่บน Cloudflare การเชื่อมต่อพวกนี้เรียกว่า API และมีอยู่ราว 18 ตัว ถ้าตัวใดตัวหนึ่งพัง (คีย์หมดอายุ · เปลี่ยนรหัส · ค่ายปิดบริการ) แอปที่พึ่งมันจะเริ่มแสดงข้อมูลเก่าหรือเงียบไปโดยไม่รู้สาเหตุ

ศูนย์ API จึงเป็น "แผงไฟหน้าตู้ควบคุม" ของพี่ไอซ์: รวมทุก API ไว้ที่เดียว แยกหมวดชัด บอกว่าแต่ละตัวเชื่อมกับใคร ยืนยันตัวตนอย่างไร ดึงข้อมูลอะไรได้ ใช้ในแอปไหนบ้าง และที่สำคัญคือมีปุ่มทดสอบสด ยิงไปที่ API จริงจากเซิร์ฟเวอร์แล้วรายงานกลับเป็นไฟเขียว/แดงพร้อมเวลาตอบสนอง (ms) — ใช้ไล่หาต้นตอเวลาแอปตัวไหน "เงียบ" ได้ในไม่กี่วินาที

🔑 ใครใช้ได้ / วิธีเข้าใช้งาน

• หน้านี้เป็นของเจ้าของเท่านั้น — เข้าได้ผ่านลิงก์กุญแจเจ้าของ (ลิงก์=กุญแจ) หรือกดการ์ด "ศูนย์ API" ในหน้าฮับฝั่งเจ้าของ เปิดครั้งแรกเครื่องจะจำคุกกี้ไว้ ~1 ปี
• ถ้าเปิดลิงก์เปล่าโดยไม่มีกุญแจ จะเจอหน้า "🔐 ศูนย์ API" ให้ใส่ช่อง กุญแจเจ้าของ... — พนักงานทั่วไปไม่มีสิทธิ์และไม่จำเป็นต้องใช้หน้านี้
• ไม่ใช้รหัสพนักงาน (PIN) เพราะไม่มีระดับพนักงาน — มีระดับเดียวคือเจ้าของ
• คีย์ลับของแต่ละ API ไม่ได้อยู่ในหน้าเว็บ เก็บเป็น secret ฝั่ง Cloudflare การกดทดสอบจึงไม่ทำให้คีย์รั่ว แม้เปิด view-source ก็ไม่เห็น

📝 วิธีใช้งานทีละขั้น

อ่านภาพรวมบนสุด

1. เปิดหน้ามาจะเห็นแถบสรุป 6 ช่อง: 🟢 เชื่อมสด · 🟡 รอคีย์ · ⚪ ทำมือ · 🟠 ยังไม่เปิด · ⚡ เช็คสดได้ · รวม — ตัวเลขคือจำนวน API ในแต่ละสถานะ
2. "เชื่อมสด" = ระบบใช้งานจริงอยู่ · "รอคีย์" = เตรียมไว้แต่ยังไม่ได้คีย์ (เช่น LINE) · "ทำมือ" = ใช้อยู่แต่ผ่านคน/เครื่องมืออื่น เช็คผ่านเว็บไม่ได้ (เช่น GfK ส่งเมล, Adobe ผ่าน MCP) · "ยังไม่เปิด" = สมัครแล้วยังไม่ได้ใช้

เลือกหมวดที่จะดู

1. กดแท็บวงกลมใต้แถบสรุป: ทั้งหมด · 🏢 ระบบธุรกิจ (GebTang POS · HumanSoft · Cartrack) · 🤖 AI (Gemini · Claude · Google Search) · 📣 สื่อสาร (Telegram 6 บอท · Facebook Graph · LINE) · 🌐 ภายนอก (Google Maps · Open-Meteo อากาศ · e-GP งานราชการ · GfK/NIQ) · 📧 อีเมล (Gmail ~10 บัญชี) · 🔧 โครงสร้าง (Cloudflare · GitHub Actions · Adobe · Apify)
2. บนมือถือแถบแท็บเลื่อนซ้าย-ขวาได้ การ์ดจะเรียงเป็นคอลัมน์เดียว

อ่านการ์ดแต่ละ API

1. หัวการ์ด = ชื่อ API + ผู้ให้บริการ + ป้ายสถานะ (เชื่อมสด/รอคีย์/ทำมือ/ยังไม่เปิด) จุดกลมหน้าชื่อจะเปลี่ยนสีหลังกดทดสอบ
2. ในการ์ดบอก Endpoint (ที่อยู่ที่ระบบยิงไป) · วิธียืนยันตัวตน · ดึงข้อมูลอะไรได้ · ข้อจำกัด (ตัวหนังสือแดง) · ใช้ในแอป (ชิปชื่อแอปที่พึ่ง API นี้) · หมายเหตุ · จัดการ/ต่ออายุ (ไปตั้งค่า/จ่ายเงินที่ไหน)
3. ใช้ช่อง "ใช้ในแอป" ย้อนกลับได้ — ถ้าแอป X มีปัญหา ให้หาการ์ดที่มีชิป X แล้วกดทดสอบตัวนั้นก่อน

ทดสอบสด

1. กด 🔍 ทดสอบสด ในการ์ดที่ต้องการ → จุดจะกะพริบน้ำเงิน "กำลังเช็ค..." สักครู่
2. ผลออกมาเป็น ✅ เขียว (ใช้ได้ + รายละเอียด เช่น "50 โมเดล", "6/6 บอท", "11 คัน") หรือ ❌ แดง (มีปัญหา + ข้อความ error) พร้อมเวลาตอบสนอง ms และรหัส HTTP
3. อยากเช็คทุกตัวทีเดียวกด ⚡ ทดสอบสดทั้งหมด ด้านบน — ระบบจะไล่ยิงทีละตัวในแท็บที่เปิดอยู่ (ถ้าอยู่แท็บ "ทั้งหมด" = ยิงครบ) เสร็จแล้วขึ้น "ทดสอบล่าสุด: วัน-เวลา"
4. การ์ดที่ขึ้น ℹ️ เช็คสดไม่ได้ คือ API ที่ทดสอบผ่านเว็บไม่ได้ (คีย์ผูกกับโดเมนอื่น · ต้อง OAuth · ยังไม่มี token) กดแล้วจะบอกว่า "ดูจากการใช้งานจริง"
5. ปุ่ม ↻ โหลดใหม่ = ดึงรายการ API ล่าสุดจากเซิร์ฟเวอร์ (ใช้หลังมีการเพิ่ม/แก้รายการ)

⚙️ ฟีเจอร์ทั้งหมด

• ทะเบียน API ราว 18 ตัว แยก 6 หมวด: ระบบธุรกิจ · AI · สื่อสาร · ภายนอก · อีเมล · โครงสร้าง
• แถบสรุปจำนวนตามสถานะ 4 แบบ (เชื่อมสด/รอคีย์/ทำมือ/ยังไม่เปิด) + จำนวนที่เช็คสดได้ + รวม
• การ์ดรายตัว: endpoint · วิธี auth · ดึงอะไรได้ · ข้อจำกัด · ใช้ในแอปไหน · หมายเหตุ · ที่จัดการ/ต่ออายุ
• ปุ่ม 🔍 ทดสอบสด รายตัว — ยิง API จริงจากเซิร์ฟเวอร์ Cloudflare คืนผล ✅/❌ + ms + HTTP
• ปุ่ม ⚡ ทดสอบสดทั้งหมด (ตามแท็บที่เปิด) + เวลาทดสอบล่าสุด
• เช็คสดได้จริงราว 11 ตัว: Cloudflare · Gemini · Claude · Cartrack · HumanSoft · Telegram · Facebook · GebTang (เช็คแค่เข้าถึงได้) · Open-Meteo · e-GP · GitHub
• คีย์ลับทุกตัวเก็บเป็น Cloudflare secret ไม่อยู่ในโค้ดหน้าเว็บ ไม่ส่งกลับเบราว์เซอร์
• ประตูกุญแจเจ้าของครอบทุกหน้า + คุกกี้จำ 1 ปี · ติดตั้ง PWA ได้ · รองรับมือถือ (การ์ดคอลัมน์เดียว แท็บเลื่อนได้)
• ป้ายท้ายหน้าบอกวันที่ตรวจระบบครั้งล่าสุด (ล่าสุด 30 มิ.ย. 2569 ทดสอบผ่านครบทุกตัวที่เช็คได้)

❓ ข้อควรรู้ / คำถามพบบ่อย

ถาม: ทดสอบแล้วขึ้น ❌ แดง ต้องทำอะไร?
ตอบ: อ่านข้อความข้าง ❌ ก่อน — ถ้าเป็น 401/403 มักเป็นคีย์หมดอายุหรือถูกเปลี่ยน ให้ไปต่ออายุที่ช่อง "จัดการ/ต่ออายุ" ในการ์ด แล้วแจ้งจอยอัปเดต secret ให้ · ถ้าเป็น timeout/5xx อาจเป็นฝั่งผู้ให้บริการล่มชั่วคราว ลองใหม่อีกสักพัก

ถาม: GebTang ขึ้นเขียวแต่ POS scraper ยังดึงข้อมูลไม่ได้?
ตอบ: การ์ด GebTang เช็คแค่ "เข้าถึงเว็บได้" (reachability) เท่านั้น ไม่ได้ล็อกอินจริง — ปัญหารหัส/หน้าเว็บ POS เปลี่ยน ต้องดูที่ตัว pos-scraper แทน

ถาม: ต่างจากหน้า "สถานะข้อมูล" (status) อย่างไร?
ตอบ: ศูนย์ API เช็ค "ท่อ" ว่ายังต่อกับผู้ให้บริการภายนอกได้ไหม ส่วนหน้าสถานะข้อมูลเช็ค "น้ำในท่อ" ว่าไฟล์/ฐานข้อมูลของแต่ละแอปสดแค่ไหน — ถ้าข้อมูลเก่าแต่ API เขียวหมด แสดงว่าปัญหาอยู่ที่งานอัตโนมัติ (Task Scheduler) ไม่ใช่ API

ถาม: มี API ใหม่ต้องเพิ่มยังไง?
ตอบ: บอกจอย/Claude ให้เพิ่มรายการในทะเบียน (ไฟล์ catalog) + ตัวเช็ค + ตั้ง secret ตอน deploy — ผู้ใช้ไม่ต้องแก้อะไรในหน้าเว็บ กด ↻ โหลดใหม่ก็เห็น