เริ่มต้นอย่างรวดเร็ว
คำแนะนำนี้จะพาคุณจากไม่มีอะไรเลยจนถึงการรวมระบบที่ใช้งานได้ภายในเวลาประมาณ 30 นาที เมื่อจบแล้วคุณจะมี:
- ราคาห้องพักโรงแรมแบบสดในเมือง ผ่าน Partner API,
- ลิงก์การจองที่ให้เครดิตการจองกับบัญชีของคุณ,
- การจองทดสอบ และ webhook แจ้งเตือนเมื่อมีการจองเกิดขึ้น
ทุกอย่างเกิดขึ้นใน staging ซึ่งเป็นสภาพแวดล้อมสำหรับการทดสอบของเรา คุณไม่จำเป็นต้องขออนุญาตเข้าถึง และการย้ายไปยัง production ในภายหลังก็ไม่ต้องขออนุมัติเช่นกัน
คำแนะนำนี้เหมาะกับคุณหรือไม่?
หัวข้อที่มีชื่อว่า “คำแนะนำนี้เหมาะกับคุณหรือไม่?”| คุณต้องการ… | เริ่มที่นี่ |
|---|---|
| แสดงโรงแรมในแอป เว็บไซต์ หรือผลิตภัณฑ์ AI ของคุณ และส่งนักเดินทางไปจองเพื่อรับค่าคอมมิชชั่น | คำแนะนำนี้ |
| จองแทนลูกค้าในฐานะตัวแทนท่องเที่ยวที่ได้รับใบอนุญาต | คำแนะนำนี้จนถึงขั้นตอนที่ 5 แล้วไปที่ การจองในฐานะตัวแทนท่องเที่ยว |
| ฝังโรงแรมที่จองได้โดยไม่ต้องเขียนการรวมระบบ | Web Components |
| ให้เอเจนต์ AI ค้นหาและจอง | MCP Servers และ Agentic Payments |
| เชื่อมต่อกับ channel manager หรือ PMS | เพิ่ม Channel Manager ของคุณ |
วิธีการทำงาน
หัวข้อที่มีชื่อว่า “วิธีการทำงาน”คุณใช้ Partner API เพื่อค้นหาโรงแรมและราคาห้องพักแบบสด โรงแรมแต่ละแห่งจะมี urlName ที่คงที่ คุณเปลี่ยนมันเป็นลิงก์ไปยัง Wink Booking Engine ที่ book.wink.travel พร้อมส่ง ID ของคุณไปด้วย นักเดินทางจะจองและชำระเงินที่นั่น และการจองจะได้รับเครดิตกับบัญชีของคุณ
ก่อนเริ่มต้น
หัวข้อที่มีชื่อว่า “ก่อนเริ่มต้น”คุณจะต้องมี:
grpcurlหรือ Postman หรือ Insomnia Partner API ใช้ gRPC ไม่ใช่ RESTcurl
ขั้นตอนที่ 1: สร้างบัญชีในสเตจจิ้ง
หัวข้อที่มีชื่อว่า “ขั้นตอนที่ 1: สร้างบัญชีในสเตจจิ้ง”Staging แยกจาก production อย่างสมบูรณ์ มีการเข้าสู่ระบบและบัญชีแยกต่างหาก
-
ไปที่ staging-app.wink.travel คลิก
Sign-In / Registerและลงทะเบียน -
คลิก
Accountsในแถบด้านซ้าย จากนั้นคลิกCreateและเลือก I am an Affiliate การจองที่คุณส่งจะได้รับเครดิตกับบัญชีนี้ ดู สร้างบัญชี
ขั้นตอนที่ 2: สร้างแอปพลิเคชัน
หัวข้อที่มีชื่อว่า “ขั้นตอนที่ 2: สร้างแอปพลิเคชัน”แอปพลิเคชันจะให้ข้อมูลรับรองแก่โค้ดของคุณ
-
บนการ์ดบัญชีของคุณ คลิก
Actions>Manage accountแล้วไปที่แท็บApplications -
คลิก
Create new applicationตั้งชื่อ และเลือก Machine-to-machine เป็นประเภทไคลเอนต์ -
ในส่วน scopes เลือก Inventory & rates (อ่าน) Partner API จะตรวจสอบ
inventory.read -
คลิก
Create applicationและคัดลอก Client ID และ Client secret รหัสลับจะแสดงเพียงครั้งเดียวและไม่สามารถเรียกคืนได้ในภายหลัง
ดู Applications สำหรับประเภทไคลเอนต์และ scopes อื่นๆ
ขั้นตอนที่ 3: รับ access token
หัวข้อที่มีชื่อว่า “ขั้นตอนที่ 3: รับ access token”curl -X POST https://staging-iam.wink.travel/oauth2/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=<YOUR_CLIENT_ID>" \ -d "client_secret=<YOUR_CLIENT_SECRET>" \ -d "scope=inventory.read"บันทึก access_token จากการตอบกลับ:
export WINK_TOKEN=<access_token>โทเค็นจะหมดอายุ ในโค้ดของคุณเอง ให้ใช้ไลบรารี OAuth2 เพื่อดึงและรีเฟรชโทเค็น ดู Authentication
หากคำขอโทเค็นถูกปฏิเสธ การตอบกลับจะเป็น JSON ที่มีรหัส error:
error | สถานะ HTTP | สาเหตุทั่วไป |
|---|---|---|
invalid_client | 401 | Client ID หรือ secret ผิด หรือใช้ข้อมูลรับรอง production กับ staging-iam |
invalid_scope | 400 | คำขอขอ scope ที่แอปพลิเคชันไม่ได้ลงทะเบียน |
unauthorized_client | 400 | แอปพลิเคชันไม่ได้รับอนุญาตใช้ grant client_credentials |
invalid_request | 400 | ขาดพารามิเตอร์ที่จำเป็น เช่น ส่ง JSON แทนฟอร์ม |
ขั้นตอนที่ 4: ค้นหา account ID ของคุณ
หัวข้อที่มีชื่อว่า “ขั้นตอนที่ 4: ค้นหา account ID ของคุณ”ทุกการเรียก Partner API ต้องระบุบัญชีที่คุณทำงานแทนใน header managing-entity-id แสดงรายการบัญชีที่โทเค็นของคุณสามารถทำงานแทนได้:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsคัดลอก accountId ของบัญชี affiliate จากขั้นตอนที่ 1:
export WINK_ACCOUNT_ID=<accountId>ขั้นตอนที่ 5: ค้นหาโรงแรมในเมือง
หัวข้อที่มีชื่อว่า “ขั้นตอนที่ 5: ค้นหาโรงแรมในเมือง”Staging มีโรงแรมทดสอบที่มีห้องว่างในกรุงเทพฯ ดังนั้นการค้นหานี้ใช้ slug bangkok-thailand:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -H "managing-entity-id: $WINK_ACCOUNT_ID" \ -d '{ "urlName": "bangkok-thailand", "userSession": { "itinerary": { "startDate": "2026-12-01", "nights": 2, "room": { "adults": 2 } }, "currencyCode": "USD", "languageCode": "en" } }' \ staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCityใช้วันที่เช็คอินในอนาคต วันที่ในอดีตจะถูกปฏิเสธ ผลลัพธ์แต่ละรายการจะมี:
name,starRatingและheroImageUrlเพียงพอสำหรับแสดงแถวผลลัพธ์,roomTypesข้อเสนอแบบสด เรียงจากห้องราคาถูกที่สุด,urlNameslug ที่คุณต้องใช้สำหรับลิงก์การจอง
ราคาจะเป็นจำนวนเต็มในหน่วยย่อย: หารด้วย 10 ยกกำลัง currencyExponent จากการตอบกลับ (2 สำหรับ USD ดังนั้น 12500 คือ $125.00)
ไม่ทราบ slug ของเมือง? ใช้ wink.partner.v1.Lookup/Search เพื่อค้นหา สำหรับเนื้อหาเต็มของที่พัก ใช้บริการ Content ดู เอกสาร Partner API สำหรับการเรียกทั้งหมด
ขั้นตอนที่ 6: สร้างลิงก์การจอง
หัวข้อที่มีชื่อว่า “ขั้นตอนที่ 6: สร้างลิงก์การจอง”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>คือurlNameของโรงแรมจากขั้นตอนที่ 5client-idคือ Client ID ของแอปพลิเคชันคุณจากขั้นตอนที่ 2configuration-idคือ ID การปรับแต่งของคุณ:Manage account>Customizationsการปรับแต่งนี้ยังตั้งค่าแบรนด์ ภาษาเริ่มต้น และสกุลเงินบนหน้าการจองด้วย
ส่งข้อมูลการค้นหาของนักเดินทาง
หัวข้อที่มีชื่อว่า “ส่งข้อมูลการค้นหาของนักเดินทาง”เพิ่มวันที่ แขก ภาษา และสกุลเงินของนักเดินทางในลิงก์เดียวกันเพื่อเปิดหน้าโรงแรมพร้อมกรอกข้อมูลเหล่านี้:
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD| พารามิเตอร์ | ความหมาย | ตัวอย่าง |
|---|---|---|
sd | วันที่เช็คอิน | sd=2027-03-14 |
n หรือ ed | จำนวนคืน หรือวันที่เช็คเอาต์ | n=2 หรือ ed=2027-03-16 |
rc | จำนวนแขกต่อห้อง | rc=a2 (ผู้ใหญ่ 2 คน) |
l | ภาษาแสดงผล | l=en |
c | สกุลเงินแสดงผล | c=USD |
p | รหัสโปรโมชั่น | p=ABC123 |
พารามิเตอร์เหล่านี้จะเขียนทับค่าเริ่มต้นที่ตั้งไว้ในการปรับแต่ง ดูคำแนะนำ ปุ่ม Book Now สำหรับรูปแบบ rc แบบเต็ม รวมเด็กและหลายห้อง
ลิงก์นี้จะเปิดหน้าโรงแรม ไม่สามารถเลือกห้องหรือราคาได้ล่วงหน้า นักเดินทางจะเลือกห้องในหน้าโรงแรมที่ราคาปัจจุบัน
ดู การลิงก์โดยตรง สำหรับการลิงก์ไปยังหน้าแรกของ booking engine แทนที่จะเป็นโรงแรมเดียว
ขั้นตอนที่ 7: ทำการจองทดสอบ
หัวข้อที่มีชื่อว่า “ขั้นตอนที่ 7: ทำการจองทดสอบ”เปิดลิงก์ของคุณ เลือกวันที่และห้อง แล้วชำระเงินด้วย บัตรทดสอบ Stripe เช่น 4242 4242 4242 4242 พร้อมวันหมดอายุในอนาคตและ CVC ใดก็ได้ ไม่มีการเรียกเก็บเงินจริงใน staging จดรหัสการจองบนหน้ายืนยันไว้ รหัสจะขึ้นต้นด้วย WNK
ขั้นตอนที่ 8: รับแจ้งเตือนเกี่ยวกับการจอง
หัวข้อที่มีชื่อว่า “ขั้นตอนที่ 8: รับแจ้งเตือนเกี่ยวกับการจอง”-
ใน Portal ไปที่
Applications > Webhooksและเพิ่ม endpoint ที่รับคำขอPOST -
สมัครรับเหตุการณ์
booking.createหรือเว้นรายการเหตุการณ์ว่างเพื่อรับทุกเหตุการณ์ในช่วงพัฒนา -
ส่งเหตุการณ์ทดสอบให้ตัวเอง จากนั้นทำการจองทดสอบอีกครั้งและตรวจสอบว่าได้รับแจ้งเตือน
ตรวจสอบลายเซ็นของทุกการส่งก่อนเชื่อถือ ดู Webhook Integration และ Webhook Events Catalog
ขั้นตอนที่ 9: ไปยัง production
หัวข้อที่มีชื่อว่า “ขั้นตอนที่ 9: ไปยัง production”ไม่มีขั้นตอนอนุมัติสำหรับนักพัฒนา (บัญชีนายหน้าท่องเที่ยวจะได้รับการรับรองก่อน ดู ด้านล่าง) เมื่อการรวมระบบของคุณทำงานใน staging:
-
สร้างบัญชีและแอปพลิเคชันที่ app.wink.travel ตามขั้นตอนที่ 1 และ 2 ข้อมูลรับรองไม่สามารถใช้ข้ามสภาพแวดล้อมได้
-
ลบ
staging-ออกจากทุกโฮสต์:Staging Production https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
ค้นหา account ID ของ production (ขั้นตอนที่ 4) และ customization ID (ขั้นตอนที่ 6) อีกครั้ง ซึ่งจะแตกต่างจาก staging
การใช้งาน Partner API จะคิดตามจำนวนคืนของโรงแรม โดยมีโควต้าฟรีรายเดือน ดู Partner API สำหรับราคาค่าบริการและข้อจำกัด
การจองในฐานะตัวแทนท่องเที่ยว
หัวข้อที่มีชื่อว่า “การจองในฐานะตัวแทนท่องเที่ยว”ถ้าบัญชีของคุณเป็นตัวแทนท่องเที่ยวที่ได้รับใบอนุญาต คุณไม่จำเป็นต้องส่งนักเดินทางไปที่ book.wink.travel คุณสามารถสร้างการจองโดยตรงด้วย wink.partner.v1.Booking/CreateBooking และจัดการการจองด้วยคำสั่ง Booking อื่นๆ บัญชีอื่นจะส่งนักเดินทางไปยังลิงก์การจองแทน
บัญชีนายหน้าท่องเที่ยวจะได้รับการรับรอง: Wink จะตรวจสอบการลงทะเบียนของตัวแทนทุกแห่งก่อนให้สามารถจองได้ ตัวแทนที่ต้องการเก็บเงินจากลูกค้าเองในฐานะผู้ค้ารายการต้องจองผ่าน Partner API และได้รับการอนุมัติเป็นลายลักษณ์อักษรจาก Wink ดู เริ่มต้นใช้งานในฐานะตัวแทนท่องเที่ยว และ เอกสาร Partner API
ขั้นตอนถัดไป
หัวข้อที่มีชื่อว่า “ขั้นตอนถัดไป”- สร้างไคลเอนต์แบบ typed จากสคีมา
.protoแทนการเรียกgrpcurlด้วยมือ - เชื่อมต่อ MCP server และใช้ AI Skills ให้ผู้ช่วยเขียนโค้ดช่วยคุณสร้างการรวมระบบกับ API แบบสด
- อ่านรายการเต็มของ สภาพแวดล้อมและโฮสต์
