Files
web-alterflixhub/docs/api.md
T
Bkk1234 42572020d8 fix(contacts): ช่องทางติดต่อกดใช้ได้จริง (tel:/mailto:/โซเชียล) + ซ่อมข้อมูลเดิม
ปัญหา: href ในข้อมูลดิบไม่สม่ำเสมอ (ว่าง / www. ไม่มี scheme / เบอร์ไม่มี tel: /
facebook ติด fbclid) ทำให้กดแล้วไม่เกิดอะไร และปุ่มโทรใช้ไม่ได้

- app/lib/contact-link.ts: resolveContact() จับคู่ลิงก์ตามชนิด
  · เบอร์ → tel:+66… (แปลง 0 นำหน้า, ตัดขีด/ช่องว่าง/วงเล็บ)
  · อีเมล → mailto: · LINE @id → line.me · เว็บ → https + ตัด fbclid/_rdc/utm_*
- ContactPanel: ไอคอนตามชนิด (phone/mail/fb/ig/line/ticket/globe),
  tel/mailto เปิดแท็บเดิม, เว็บเปิดแท็บใหม่; แถวที่ไม่มีลิงก์แสดงเป็นข้อความ (ไม่หลอกให้กด)
- sanitizeCinemas: คำนวณ href ใหม่ทุกครั้งที่บันทึก → ข้อมูลเก่าไม่กลับมาเพี้ยน
- ContactsEditor: auto-format ตอนออกจากช่อง + พรีวิว "✓ กดโทรได้ → tel:+66…"
- scripts/audit-contacts.mjs [--fix]: ตรวจ/ซ่อมทั้งไฟล์ (แก้ไป 13 จุด, สำรองข้อมูลแล้ว)
- contact-link.spec.ts 13 tests · docs: admin-guide/api/DESIGN
2026-11-15 23:56:46 +07:00

5.5 KiB

API reference — AlterFlixHub

ทุก endpoint เป็น JSON และอยู่ใต้ path /api ของแอปเอง (ไม่ต้องมี prefix อื่น) ค่าเริ่มต้น: Content-Type: application/json · error ใช้รูปแบบ { statusMessage } หรือ { message }

สาธารณะ (ไม่ต้องล็อกอิน)

Method Path Body / Query ทำอะไร
POST /api/analytics/collect { type, locale, query?, category?, result_count?, slug?, source?, position? } รับ event สถิติ 1 ครั้ง — เซิร์ฟเวอร์เป็นผู้ใส่ at และ hash ผู้เข้าชม (sha256(เกลือรายวัน | ip | ua) 16 ตัวอักษร) ไม่ใช้คุกกี้ ไม่เก็บ IP/UA ดิบ
GET /uploads/cinemas/<ไฟล์> — เสิร์ฟรูปที่อัปโหลดจากหลังบ้าน (อ่านจาก data/uploads/cinemas/) · Cache-Control: immutable · กัน path traversal

type ที่รองรับ: search · cinema_select · cinema_view · near_me

หลังบ้าน (ต้องมีคุกกี้ afx_admin)

Method Path Body / Query ทำอะไร
POST /api/admin/login { username, password } ตรวจรหัส → ออกคุกกี้ HttpOnly เซ็น HMAC (8 ชั่วโมง)
POST /api/admin/logout — ลบคุกกี้ session
GET /api/admin/session — ตรวจว่ายังล็อกอินอยู่
GET /api/admin/content — อ่าน ContentStore ทั้งก้อน (cinemas, site, about, forCinemas, forFilmLovers)
POST /api/admin/uploads multipart/form-data: file (บังคับ, ≤ 8 MB), slug (ไม่บังคับ) อัปโหลดรูปโรงหนัง — ตรวจชนิดจริงจาก magic bytes (JPEG/PNG/WebP/AVIF) เก็บที่ data/uploads/cinemas/ คืน { url, bytes, type } โดย url = /uploads/cinemas/<ไฟล์>
PUT /api/admin/content { cinemas?, site?, about?, forCinemas?, forFilmLovers? } บันทึกเฉพาะส่วนที่ส่งมา — ผ่าน sanitizeCinemas / sanitizeSite / sanitizeAbout / sanitizeForCinemas / sanitizeForFilmLovers แล้วเขียนไฟล์แบบ atomic · contacts[].href ถูกคำนวณใหม่ให้กดใช้ได้จริง (tel:/mailto:/https:) ทุกครั้ง
POST /api/admin/cinemas/import { cinemas: Cinema[] } หรือรายการเดียว นำเข้าโรงหนังโดยใช้ slug เป็นกุญแจ (มีอยู่ = ทับ)
GET /api/admin/analytics ?days=1|7|30|90 สรุปสถิติ (summarize()) — คำค้นยอดนิยม, คำค้นไม่พบผล, CTR, โรงที่ถูกเปิด/คลิก

ข้อมูลที่ฝังมากับ loader (ไม่ใช่ API)

Route ค่าที่ส่งมา
/ (root loader) content (cinemas/site/about/forCinemas/forFilmLovers) + localeFromUrl + siteUrl และ shareOrigin (origin ของ request ใช้ทำ canonical/OG/ลิงก์แชร์ — ไม่ฝังโดเมน)
/ (_index loader) popularity + orderKey (สลับลำดับการ์ดรายวัน) + origin
/cinema/:slug ฟิลด์ SEO ของโรง (name, description, locationLabel, coordinates, mapUrl, photo) + origin แล้วนำไปสร้าง meta/JSON-LD
/about · /for-cinemas · /for-film-lovers · /admin · /admin/login { origin } — meta() ของ React Router ไม่มี access ต่อ request จึงต้องส่งมาจาก loader
/sitemap.xml · /robots.txt ไม่ใช่ loader ของ React — เป็น Nitro route (server/routes/) อ่าน origin จาก header เอง

ตัวอย่างเรียก

# บันทึกเฉพาะ cinemas (เช่น หลังลากสลับลำดับ)
curl -X PUT http://localhost:8080/api/admin/content \
  -H 'Content-Type: application/json' \
  --cookie "$(cat .output/afx_admin.cookie)" \
  -d '{"cinemas": [...]}'

# อ่านสถิติ 30 วัน
curl -H "Cookie: afx_admin=$TOKEN" \
  'http://localhost:8080/api/admin/analytics?days=30'

ข้อควรระวัง

  • PUT /api/admin/content เขียนทับทั้งก้อนของส่วนที่ส่งมา — ถ้าส่ง cinemas ต้องส่งของครบทุกรายการ ไม่ใช่แค่ตัวที่แก้
  • slug เปลี่ยนแล้วลิงก์เดิม /cinema/<slug> จะ 404 (ยังไม่มี redirect table)
  • ไฟล์จริงอยู่ที่ data/content/content.json · สถิติที่ data/analytics/events.jsonl — ทั้งคู่ไม่ควรถูกเขียนด้วยมือระหว่างเซิร์ฟเวอร์รัน