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

เริ่มต้นอย่างรวดเร็ว

คำแนะนำนี้จะพาคุณจากไม่มีอะไรเลยจนถึงการรวมระบบที่ใช้งานได้ภายในเวลาประมาณ 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 ไม่ใช่ REST
  • curl

Staging แยกจาก production อย่างสมบูรณ์ มีการเข้าสู่ระบบและบัญชีแยกต่างหาก

  1. ไปที่ staging-app.wink.travel คลิก Sign-In / Register และลงทะเบียน

  2. คลิก Accounts ในแถบด้านซ้าย จากนั้นคลิก Create และเลือก I am an Affiliate การจองที่คุณส่งจะได้รับเครดิตกับบัญชีนี้ ดู สร้างบัญชี

แอปพลิเคชันจะให้ข้อมูลรับรองแก่โค้ดของคุณ

  1. บนการ์ดบัญชีของคุณ คลิก Actions > Manage account แล้วไปที่แท็บ Applications

  2. คลิก Create new application ตั้งชื่อ และเลือก Machine-to-machine เป็นประเภทไคลเอนต์

  3. ในส่วน scopes เลือก Inventory & rates (อ่าน) Partner API จะตรวจสอบ inventory.read

  4. คลิก Create application และคัดลอก Client ID และ Client secret รหัสลับจะแสดงเพียงครั้งเดียวและไม่สามารถเรียกคืนได้ในภายหลัง

ดู Applications สำหรับประเภทไคลเอนต์และ scopes อื่นๆ

Terminal window
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 จากการตอบกลับ:

Terminal window
export WINK_TOKEN=<access_token>

โทเค็นจะหมดอายุ ในโค้ดของคุณเอง ให้ใช้ไลบรารี OAuth2 เพื่อดึงและรีเฟรชโทเค็น ดู Authentication

หากคำขอโทเค็นถูกปฏิเสธ การตอบกลับจะเป็น JSON ที่มีรหัส error:

errorสถานะ HTTPสาเหตุทั่วไป
invalid_client401Client ID หรือ secret ผิด หรือใช้ข้อมูลรับรอง production กับ staging-iam
invalid_scope400คำขอขอ scope ที่แอปพลิเคชันไม่ได้ลงทะเบียน
unauthorized_client400แอปพลิเคชันไม่ได้รับอนุญาตใช้ grant client_credentials
invalid_request400ขาดพารามิเตอร์ที่จำเป็น เช่น ส่ง JSON แทนฟอร์ม

ทุกการเรียก Partner API ต้องระบุบัญชีที่คุณทำงานแทนใน header managing-entity-id แสดงรายการบัญชีที่โทเค็นของคุณสามารถทำงานแทนได้:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

คัดลอก accountId ของบัญชี affiliate จากขั้นตอนที่ 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging มีโรงแรมทดสอบที่มีห้องว่างในกรุงเทพฯ ดังนั้นการค้นหานี้ใช้ slug bangkok-thailand:

Terminal window
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 ข้อเสนอแบบสด เรียงจากห้องราคาถูกที่สุด,
  • urlName slug ที่คุณต้องใช้สำหรับลิงก์การจอง

ราคาจะเป็นจำนวนเต็มในหน่วยย่อย: หารด้วย 10 ยกกำลัง currencyExponent จากการตอบกลับ (2 สำหรับ USD ดังนั้น 12500 คือ $125.00)

ไม่ทราบ slug ของเมือง? ใช้ wink.partner.v1.Lookup/Search เพื่อค้นหา สำหรับเนื้อหาเต็มของที่พัก ใช้บริการ Content ดู เอกสาร Partner API สำหรับการเรียกทั้งหมด

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> คือ urlName ของโรงแรมจากขั้นตอนที่ 5
  • client-id คือ Client ID ของแอปพลิเคชันคุณจากขั้นตอนที่ 2
  • configuration-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 แทนที่จะเป็นโรงแรมเดียว

เปิดลิงก์ของคุณ เลือกวันที่และห้อง แล้วชำระเงินด้วย บัตรทดสอบ Stripe เช่น 4242 4242 4242 4242 พร้อมวันหมดอายุในอนาคตและ CVC ใดก็ได้ ไม่มีการเรียกเก็บเงินจริงใน staging จดรหัสการจองบนหน้ายืนยันไว้ รหัสจะขึ้นต้นด้วย WNK

  1. ใน Portal ไปที่ Applications > Webhooks และเพิ่ม endpoint ที่รับคำขอ POST

  2. สมัครรับเหตุการณ์ booking.create หรือเว้นรายการเหตุการณ์ว่างเพื่อรับทุกเหตุการณ์ในช่วงพัฒนา

  3. ส่งเหตุการณ์ทดสอบให้ตัวเอง จากนั้นทำการจองทดสอบอีกครั้งและตรวจสอบว่าได้รับแจ้งเตือน

ตรวจสอบลายเซ็นของทุกการส่งก่อนเชื่อถือ ดู Webhook Integration และ Webhook Events Catalog

ไม่มีขั้นตอนอนุมัติสำหรับนักพัฒนา (บัญชีนายหน้าท่องเที่ยวจะได้รับการรับรองก่อน ดู ด้านล่าง) เมื่อการรวมระบบของคุณทำงานใน staging:

  1. สร้างบัญชีและแอปพลิเคชันที่ app.wink.travel ตามขั้นตอนที่ 1 และ 2 ข้อมูลรับรองไม่สามารถใช้ข้ามสภาพแวดล้อมได้

  2. ลบ staging- ออกจากทุกโฮสต์:

    StagingProduction
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. ค้นหา 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