ข้ามไปยังเนื้อหา

แอปพลิเคชัน

แอปพลิเคชันช่วยให้คุณเข้าถึงฟีเจอร์ทั้งหมดของ Wink ในฐานะนักพัฒนา คุณสามารถเข้าถึงข้อมูลทั้งหมดเหมือนกันและขยายฟีเจอร์ของ Wink ได้ คุณสามารถเลือกใช้เซิร์ฟเวอร์ OAuth2 ของ Wink เพื่อยืนยันตัวตนเว็บไซต์ท่องเที่ยวของคุณในแบบเดียวกับที่ใช้ Google หรือ Facebook ด้วยวิธีนี้คุณสามารถขยายฟีเจอร์ของ Wink ไปยังเว็บไซต์หรือแอปพลิเคชันของคุณเองได้

ตัวอย่างแอปพลิเคชัน
ตัวอย่างการเข้าสู่ระบบแอปพลิเคชัน
  1. เลือกบัญชีที่คุณต้องการทำงานด้วยจาก Accounts
  2. คลิกที่ Actions ที่ด้านล่างของการ์ดบัญชีแล้วเลือก Manage account
  3. คลิกแท็บ Applications ในหน้าถัดไป
  4. ส่วนนี้จะแสดงรายการแอปพลิเคชันทั้งหมดของคุณ
  5. หมุนเวียนหรือ ลบแอปที่มีอยู่ หรือสร้างแอปใหม่

เนื่องจากคุณไม่สามารถเข้าถึง secret key ของแอปที่เราสร้างให้คุณได้ คุณจะต้องสร้างแอปของคุณเอง คุณสามารถสร้างแอปพลิเคชันที่นี่โดยไม่ต้องตั้งค่าทรัพย์สินหรือบริษัทก่อน — แอปจะไม่ผูกกับบัญชีใดบัญชีหนึ่ง

เมื่อสร้างแอปพลิเคชัน คุณจะเลือกประเภทไคลเอนต์ที่กำหนดวิธีการยืนยันตัวตนของแอป ประเภทนี้ไม่สามารถเปลี่ยนแปลงได้ภายหลัง — หากคุณต้องการประเภทอื่น ให้สร้างแอปใหม่

  • Web application — แอปที่เรนเดอร์บนเซิร์ฟเวอร์ซึ่งสามารถเก็บ client secret ได้อย่างปลอดภัย (authorization code flow)
  • Single-page app (SPA) — แอปในเบราว์เซอร์ที่ไม่มีแบ็กเอนด์; ใช้ PKCE โดยไม่มี client secret
  • Mobile app — แอปเนทีฟ iOS/Android; ใช้ PKCE พร้อม refresh token แบบหมุนเวียน
  • Machine-to-machine — บริการแบ็กเอนด์ที่ทำงานในนามของตัวเอง (client credentials); ไม่มีการลงชื่อเข้าใช้ผู้ใช้

ขั้นตอนการสร้างแอปพลิเคชันมีดังนี้:

  1. จากหน้ารายการแอป คลิกปุ่ม Create new application
  2. ชื่อ ตั้งชื่อแอปของคุณ เช่น Cool App
  3. ประเภทไคลเอนต์ เลือกประเภทที่ตรงกับวิธีการยืนยันตัวตนของแอป — ดู ประเภทไคลเอนต์ ข้างต้น
  4. Redirect URIs ต้องระบุอย่างน้อยหนึ่ง redirect URI ใช้สำหรับตรวจสอบโดเมน redirect หลังจากยืนยันตัวตนสำเร็จ ไม่ใช้กับแอป Machine-to-machine เช่น https://www.cool-site.com
  5. Post-logout redirect URIs (ไม่บังคับ) URL ที่ผู้ใช้จะถูกเปลี่ยนเส้นทางหลังจากออกจากระบบ ปล่อยว่างเพื่อใช้ redirect URIs ข้างต้นซ้ำ
  6. Scopes เลือกสิ่งที่แอปนี้สามารถเข้าถึงในนามของคุณ — ดู การเลือก scopes ด้านล่าง
  7. คลิกปุ่ม Create application เพื่อดำเนินการต่อ

คุณจะถูกเปลี่ยนเส้นทางกลับไปยังรายการแอปพลิเคชันของคุณ และจะมีไดอะล็อกแสดง Client ID และ Client secret ใหม่เพียงครั้งเดียว คัดลอก secret ตอนนี้และเก็บไว้ในที่ปลอดภัย — จะไม่แสดงอีก และไม่มีวิธีเรียกคืน (มีเพียงการ หมุนเวียน เพื่อรับใหม่เท่านั้น)

แอปพลิเคชันทุกตัวจะมี Sign-in (OpenID Connect) scopes (openid, profile, email, offline_access) เสมอ — scopes เหล่านี้ยืนยันตัวตนผู้ใช้และเก็บสถานะการลงชื่อเข้าใช้ จึงถูกเลือกและล็อกไว้; ไม่ใช่ตัวเลือก

ส่วนที่เหลือเป็นแบบเลือกได้ Scopes ที่เหลือจะถูกจัดกลุ่มตามส่วนการทำงานเดียวกันที่อธิบายไว้ใน Scopes — บัญชี, สต็อกและอัตรา, การจอง, การตลาดและโปรโมชั่น, เนื้อหาทรัพย์สิน, การวิเคราะห์และรายงาน, การรวมระบบผู้จัดการช่องทาง, การชำระเงิน และบัญชีและสมุดรายวัน — แต่ละส่วนมีคำอธิบายง่าย ๆ ว่าปลดล็อกอะไร ใช้ลิงก์ All / None ข้างบนรายการเพื่อเลือกหรือยกเลิกเลือก scopes ตัวเลือกทั้งหมดพร้อมกัน

มีสองกลุ่ม scopes ที่ ไม่เสนอ ในฟอร์มนี้:

  • mcp.* — การเข้าถึง AI-agent สำหรับ Model Context Protocol คุณไม่สร้างแอปสำหรับสิ่งนี้: ไคลเอนต์ AI เช่น Claude, ChatGPT หรือ Codex จะลงทะเบียนตัวเองและขอ scopes เหล่านี้เมื่อคุณลงชื่อเข้าใช้ผ่านหน้าจอการยินยอม MCP พวกนี้ไม่เคยให้กับแอป machine-to-machine เพราะ MCP ทำงานในนามของผู้ใช้ที่ลงชื่อเข้าใช้เสมอ
  • Scopes ระดับผู้ดูแลระบบ (administrator.*) — การเข้าถึงระดับแพลตฟอร์มที่ไม่ให้ต่อแอปแต่ละตัว

เมื่อสร้างแอปแล้ว ทั้งแท็บนี้และ Consented Apps จะแสดง scopes ที่ได้รับอนุญาตจัดกลุ่มตามส่วน (เช่น “Bookings: booking.read”) เพื่อให้คุณเห็นว่าแอปทำอะไรได้บ้างโดยไม่ต้องเปิดดูรายละเอียด

หาก client secret อาจรั่วไหล หรือคุณต้องการข้อมูลรับรองใหม่ ให้หมุนเวียนแทนการสร้างแอปใหม่:

  1. หาแอปในรายการแอปพลิเคชันของคุณแล้วคลิก Rotate
  2. ยืนยันในไดอะล็อก — Client ID และ secret ปัจจุบันจะหยุดทำงานทันที
  3. คัดลอก Client ID และ secret ใหม่จากไดอะล็อกที่แสดงเพียงครั้งเดียวก่อนปิด

การหมุนเวียนจะเก็บชื่อแอป ประเภทไคลเอนต์ redirect URIs และ scopes ไว้ — มีเพียงข้อมูลรับรองที่เปลี่ยนเท่านั้น

ถ้าคุณไม่ต้องการใช้แอปใดอีกต่อไป คุณสามารถลบได้ การลบเป็นการถาวร — ข้อมูลรับรองจะถูกเพิกถอนทันทีและไม่สามารถกู้คืนได้

  1. หาแอปในรายการแอปพลิเคชันของคุณแล้วคลิก Delete
  2. ยืนยันในไดอะล็อกเพื่อลบแอปพลิเคชันอย่างถาวร