Partner API

Wink Partner API คือวิธีการที่มีการยืนยันตัวตนและรองรับปริมาณข้อมูลสูงสำหรับผู้รวมระบบในการค้นหาสินค้าท่องเที่ยวที่สามารถจองได้ — ซัพพลายเดียวกับที่ขับเคลื่อนวิดเจ็ตฝังตัวและจุดเชื่อมต่อสาธารณะสำหรับการเรียกดู ซึ่งเปิดเผยในรูปแบบอินเทอร์เฟซโปรแกรมมิ่งระดับชั้นหนึ่ง ในขณะที่ Web Components ฟรีและจุดเชื่อมต่อสาธารณะสำหรับการเรียกดูเหมาะสำหรับการฝังที่เบาและมุ่งเน้นผู้ใช้ทั่วไป Partner API ถูกสร้างขึ้นสำหรับระบบที่ค้นหา กำหนดราคา และจองในระดับขนาดใหญ่ การเข้าถึงมีการยืนยันตัวตนแยกตามผู้รวมระบบและคิดค่าบริการตามการใช้งานจริง ดังนั้นคุณจึงจ่ายเฉพาะปริมาณข้อมูลที่คุณส่งจริงเท่านั้น

แผนและราคา

หนึ่งการเรียก API = หนึ่งคำขอ การใช้งานที่วัดปริมาณจะถูกคิดค่าบริการต่อ 1,000 คำขอ

	ฟรี	จ่ายเงิน	องค์กร
ราคา	$0	คิดตามการใช้งาน	ติดต่อเรา
เหมาะสำหรับ	การประเมิน & การรวมระบบปริมาณต่ำ	จ่ายตามการใช้งานที่ขยายขนาดได้	ปริมาณตามสั่ง & เงื่อนไขเจรจา
คำขอต่อหนึ่งนาที	30 (ระเบิด 60)	ไม่จำกัด	ไม่จำกัด
คำขอต่อเดือน	10,000	ไม่จำกัด	ไม่จำกัด
เวลาตอบสนอง API (P95)	—	ต่ำกว่า 500 มิลลิวินาที	ต่ำกว่า 500 มิลลิวินาที
ราคาต่อ 1,000 คำขอ	ฟรี	$1.00	กำหนดเอง
ค่าปรับ Look-to-book เกิน (ต่อ 1,000 การค้นหาที่เกิน 5,000:1)	—	$2.00	กำหนดเอง
การตอบกลับเมื่อเกินอัตรา	429 (หยุดชั่วคราว / หยุดถาวรรายเดือน)	ไม่มี	ไม่มี
ข้อตกลงระดับการให้บริการ	—	✓	✓
การสนับสนุนลำดับความสำคัญ	—	✓	✓
การเริ่มต้นใช้งานเฉพาะ	—	—	✓

รับคีย์ API · เริ่มการคิดค่าบริการตามการใช้งาน · ติดต่อฝ่ายขาย

เอกสารอ้างอิง API

มีสองส่วนที่ให้บริการสินค้าท่องเที่ยวที่สามารถจองได้ และสอดคล้องกับสองระดับข้างต้น:

ฟรี — Consumer / Booking Engine API (REST, /api/public/**): ไม่ระบุตัวตน, สำหรับเบราว์เซอร์และวิดเจ็ต. เรียกดูเอกสาร Booking Engine →
จ่ายเงิน — Partner Integrator API (gRPC, wink.partner.v1): มีการยืนยันตัวตน, วัดปริมาณการใช้งาน, สร้างขึ้นสำหรับการรวมระบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ในระดับขนาดใหญ่. เรียกดูเอกสาร Integrator →

Partner Integrator API เป็น gRPC ไม่ใช่ REST คุณเรียกใช้งานด้วยไคลเอนต์ที่สร้างขึ้นผ่าน HTTP/2 ที่ partner.wink.travel:443 โดยส่งโทเค็น Bearer และบัญชีที่คุณเรียกใช้งาน:

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

หน้าการอ้างอิงข้างต้นมีเอกสารทุกบริการ ข้อความ และสถานะข้อผิดพลาด และสคีมานี้ยังสามารถเข้าถึงได้ในเวลารันไทม์ผ่านการสะท้อนเซิร์ฟเวอร์ ดังนั้น grpcurl, Postman และ Insomnia จึงค้นพบได้โดยไม่ต้องดาวน์โหลดอะไรเพิ่มเติม

หากคุณต้องการสร้างไคลเอนต์ล่วงหน้า ไฟล์ต้นฉบับ .proto ได้เผยแพร่ที่ github.com/wink-travel/partner-api-proto

วิธีการทำงานของการใช้งานและข้อจำกัด

ระดับฟรี

ระดับฟรีถูกออกแบบมาเพื่อให้คุณสร้าง ทดสอบ และใช้งานในระดับการผลิตที่ไม่สูงโดยไม่มีค่าใช้จ่าย

ข้อจำกัดอัตรา — 30 คำขอต่อหนึ่งนาที พร้อมระเบิด 60 คำขอ. ช่วงเวลาสั้น ๆ ที่เกินอัตราคงที่จะถูกดูดซับโดยการระเบิด หากคุณเกินขีดจำกัดนี้ API จะตอบกลับด้วย HTTP 429 (คำขอมากเกินไป) และหยุดให้บริการเป็นเวลา 5 นาที ก่อนที่คีย์ของคุณจะกลับมาให้บริการอีกครั้ง หลีกเลี่ยงการเรียกซ้ำอย่างหนักในช่วงเวลาหยุดนี้
โควต้ารายเดือน — 10,000 คำขอต่อเดือนปฏิทิน. เมื่อคุณถึงขีดจำกัดรายเดือน API จะส่งกลับ HTTP 429 ตลอดช่วงเวลาที่เหลือของเดือน — หยุดถาวร — พร้อมข้อความเชิญชวนให้สมัครใช้ระดับจ่ายเงินเพื่อใช้งานต่อ ตัวนับจะรีเซ็ตเมื่อเริ่มเดือนปฏิทินถัดไป

ระดับฟรีไม่มีข้อตกลงระดับการให้บริการหรือการสนับสนุนลำดับความสำคัญ

ระดับจ่ายเงิน

ระดับจ่ายเงินจะยกเลิกขีดจำกัดรายเดือนและการหยุดชั่วคราวจากข้อจำกัดอัตรา และคิดค่าบริการเฉพาะที่คุณใช้งานจริง

คำขอที่วัดปริมาณ — $1.00 ต่อ 1,000 คำขอ. ไม่มีขีดจำกัดคำขอต่อเดือนและไม่มีการจำกัดอัตราในสภาวะปกติ; คุณจะถูกเรียกเก็บตามปริมาณจริง
ค่าปรับ Look-to-book เกิน — $2.00 ต่อ 1,000 การค้นหาที่เกิน. เพื่อรักษาสภาพซัพพลายให้ดี เราจะวัดอัตราส่วนของการค้นหา (“looks”) ต่อการจองที่ยืนยัน คุณมีสิทธิ์ใช้ 5,000 การค้นหาต่อการจองหนึ่งครั้ง ก่อนที่จะมีค่าปรับ การค้นหาที่เกินจะคำนวณเป็น:

excess = max(0, looks − bookings × 5,000)

ค่าปรับจะถูกคิดที่ $2.00 ต่อ 1,000 การค้นหาที่เกิน การรวมระบบที่มีอัตราการแปลงดีมักจะไม่เกิดค่าปรับ; ค่าปรับจะถูกใช้กับปริมาณการค้นหาที่มากกว่าการจองอย่างมากเท่านั้น

ระดับจ่ายเงินรวมข้อตกลงระดับการให้บริการที่อธิบายไว้ด้านล่าง — การรับประกันเวลาทำงาน 99.9% และเป้าหมายเวลาตอบสนอง P95 ต่ำกว่า 500 มิลลิวินาที — และการสนับสนุนลำดับความสำคัญตามความรุนแรง

ข้อตกลงระดับการให้บริการ

วันที่มีผล: 5 กรกฎาคม 2026 · เวอร์ชัน 1.0

ข้อตกลงระดับการให้บริการนี้ (“SLA”) กำหนดความมุ่งมั่นด้านความพร้อมใช้งาน เครดิตบริการ และเป้าหมายการสนับสนุนที่ Wink (“Wink”, “เรา”, “พวกเรา”) มอบให้แก่ลูกค้า (“ลูกค้า”, “คุณ”) สำหรับ Wink Partner API ที่มีการยืนยันตัวตน (“Partner API” หรือ “บริการ”) ในระดับที่ระบุว่าใช้ SLA นี้ ข้อตกลงนี้ถูกรวมเข้าและถูกควบคุมโดยข้อตกลงระหว่างคุณกับ Wink ซึ่งคุณเข้าถึง Partner API (“ข้อตกลง”) และใช้บังคับตราบเท่าที่คุณรักษาการสมัครสมาชิก Partner API ที่ชำระเงินและอยู่ในสถานะดี คำศัพท์ที่ใช้ตัวพิมพ์ใหญ่ซึ่งไม่ได้กำหนดไว้ที่นี่มีความหมายตามที่ระบุในข้อตกลง

1. คำจำกัดความ

“เวลาทำงาน” หมายถึงช่วงเวลาที่ Partner API พร้อมให้บริการรับและตอบสนองคำขอที่ถูกต้องและยืนยันตัวตนสำเร็จ
“เวลาหยุดทำงาน” หมายถึงช่วงเวลาที่วัดเป็นนาทีซึ่ง Partner API ไม่สามารถตอบสนองคำขอที่ถูกต้องและยืนยันตัวตนสำเร็จได้ โดยไม่รวมช่วงเวลาที่ตกอยู่ในข้อยกเว้นตามมาตรา 4 ข้อผิดพลาดที่เกิดขึ้นแยกส่วนและส่งผลกระทบต่อคำขอเพียงส่วนน้อยไม่ถือเป็นเวลาหยุดทำงาน
“เปอร์เซ็นต์เวลาทำงานรายเดือน” หมายถึงจำนวนรวมของนาทีในเดือนปฏิทินนั้น ลบด้วยเวลาหยุดทำงานทั้งหมด หารด้วยจำนวนรวมของนาทีในเดือนนั้น แสดงเป็นเปอร์เซ็นต์
“การบำรุงรักษาที่กำหนดเวลา” หมายถึงการบำรุงรักษาบริการที่วางแผนไว้ซึ่ง Wink ได้แจ้งล่วงหน้าตามมาตรา 4
“เครดิตบริการ” หมายถึงเครดิตที่คำนวณเป็นเปอร์เซ็นต์ของค่าธรรมเนียมที่คุณจ่ายหรือค้างชำระสำหรับ Partner API ในเดือนปฏิทินที่ได้รับผลกระทบ ซึ่งนำไปหักล้างค่าธรรมเนียม Partner API ในอนาคตเป็นการเยียวยาเดียวและเฉพาะสำหรับการไม่ปฏิบัติตามความมุ่งมั่นเวลาทำงาน
“เวลาตอบสนอง” หมายถึงเวลาที่ผ่านไประหว่าง Wink รับคำขอที่ถูกต้องและยืนยันตัวตนที่ขอบเขตบริการของ Wink จนถึงจุดที่ Wink เริ่มส่งกลับการตอบสนอง โดยไม่รวมเวลาขนส่งเครือข่ายและเวลาฝั่งไคลเอนต์ที่อยู่นอกการควบคุมของ Wink

2. ความมุ่งมั่นด้านความพร้อมใช้งานและประสิทธิภาพ

Wink จะใช้ความพยายามอย่างสมเหตุสมผลในเชิงพาณิชย์เพื่อให้ Partner API พร้อมใช้งานที่ เปอร์เซ็นต์เวลาทำงานรายเดือนอย่างน้อย 99.9% ในแต่ละเดือนปฏิทินของระยะเวลาสัญญา (“ความมุ่งมั่นเวลาทำงาน”) ความมุ่งมั่นเวลาทำงานนี้วัดที่ขอบเขตบริการของ Wink และไม่รวมปัจจัยที่อยู่นอกการควบคุมอย่างสมเหตุสมผลของ Wink รวมถึงที่ระบุในมาตรา 4 ระบบตรวจสอบของ Wink เป็นแหล่งข้อมูลที่เชื่อถือได้สำหรับการวัดเปอร์เซ็นต์เวลาทำงานรายเดือนและเวลาตอบสนอง

Wink ยังตั้งเป้า เวลาตอบสนองเปอร์เซ็นไทล์ที่ 95 (P95) ต่ำกว่า 500 มิลลิวินาที สำหรับคำขอที่ถูกต้องและยืนยันตัวตนสำเร็จ วัดที่ขอบเขตบริการของ Wink ในแต่ละเดือนปฏิทิน (“เป้าหมายประสิทธิภาพ”) เป้าหมายประสิทธิภาพนี้ไม่รวมปัจจัยที่ระบุในมาตรา 4 คำขอที่ส่งกลับข้อผิดพลาดระดับแอปพลิเคชันที่เกิดจากคำขอเอง และคำขอแบตช์ที่มีขนาดใหญ่หรือซับซ้อนผิดปกติ เป้าหมายประสิทธิภาพเป็นวัตถุประสงค์ของบริการ เครดิตบริการในมาตรา 3 จะใช้กับความล้มเหลวในการปฏิบัติตาม ความมุ่งมั่นเวลาทำงาน เท่านั้น และเป็นการเยียวยาเดียวและเฉพาะสำหรับความล้มเหลวด้านความพร้อมใช้งาน

3. เครดิตบริการ

หากเปอร์เซ็นต์เวลาทำงานรายเดือนต่ำกว่าความมุ่งมั่นเวลาทำงานในเดือนปฏิทินใด ๆ คุณอาจมีสิทธิ์ได้รับเครดิตบริการซึ่งคำนวณเป็นเปอร์เซ็นต์ของค่าธรรมเนียม Partner API ที่คุณจ่ายหรือค้างชำระสำหรับเดือนนั้น ตามระดับดังนี้:

เปอร์เซ็นต์เวลาทำงานรายเดือน	เครดิตบริการ
ต่ำกว่า 99.9% แต่ไม่ต่ำกว่า 99.0%	10%
ต่ำกว่า 99.0% แต่ไม่ต่ำกว่า 95.0%	25%
ต่ำกว่า 95.0%	50%

การเรียกร้องเครดิต. เพื่อรับเครดิตบริการ คุณต้องส่งคำร้องเป็นลายลักษณ์อักษรถึง Wink ภายใน สามสิบ (30) วัน นับจากสิ้นเดือนปฏิทินที่เกิดความล้มเหลว คำร้องต้องระบุวันที่และเวลาของแต่ละเหตุการณ์เวลาหยุดทำงานที่คุณเรียกร้อง พร้อมบันทึกหรือหลักฐานสนับสนุนที่คุณมีอยู่ตามสมควร คำร้องที่ส่งหลังจากช่วงเวลานี้จะไม่ได้รับสิทธิ์
รูปแบบเครดิต. เครดิตบริการที่ได้รับการอนุมัติจะถูกนำไปหักล้างค่าธรรมเนียม Partner API ในอนาคตและไม่มีมูลค่าเป็นเงินสด ไม่ใช่การคืนเงินและจะไม่จ่ายเป็นเงินสดเว้นแต่กฎหมายที่ใช้บังคับกำหนด
เครดิตสูงสุด. เครดิตบริการรวมสูงสุดที่มอบให้ในเดือนปฏิทินใด ๆ จะไม่เกิน 50% ของค่าธรรมเนียม Partner API ที่คุณจ่ายหรือค้างชำระสำหรับเดือนนั้น
การเยียวยาเดียวและเฉพาะ. เครดิตบริการเป็น การเยียวยาเดียวและเฉพาะ สำหรับความล้มเหลวใด ๆ ของ Wink ในการปฏิบัติตามความมุ่งมั่นเวลาทำงานหรือความล้มเหลวด้านความพร้อมใช้งานอื่น ๆ ของ Partner API

4. ข้อยกเว้น

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

การบำรุงรักษาที่กำหนดเวลา ซึ่ง Wink ได้แจ้งล่วงหน้าตามช่องทางที่ Wink ใช้สื่อสารกับลูกค้าเป็นประจำ
เหตุการณ์ เหตุสุดวิสัย หรือสาเหตุอื่น ๆ ที่อยู่นอกการควบคุมอย่างสมเหตุสมผลของ Wink รวมถึงภัยธรรมชาติ การกระทำของรัฐบาล ความล้มเหลวของเครือข่ายหรือสาธารณูปโภค และการโจมตีแบบปฏิเสธการให้บริการหรือการโจมตีที่เป็นอันตรายอื่น ๆ
ปัญหาที่เกิดจากการกระทำหรือการละเลยของ คุณ อุปกรณ์ ซอฟต์แวร์ หรือเครือข่ายของคุณ หรือบริการ ผลิตภัณฑ์ หรือผู้ให้บริการ บุคคลที่สาม ที่ไม่อยู่ภายใต้การควบคุมโดยตรงของ Wink
การ ละเมิดการใช้บริการ หรือ การฝ่าฝืนข้อตกลง นี้ SLA ข้อกำหนดการใช้งานที่ยอมรับได้ หรือข้อจำกัดอัตราที่ใช้บังคับ รวมถึงปริมาณการใช้งานที่ Wink เห็นว่าเกินควร การละเมิดอัตโนมัติ หรือการฉ้อโกง
การ ระงับหรือยกเลิก การเข้าถึงของคุณที่ดำเนินการอย่างถูกต้องตามข้อตกลง รวมถึงการระงับเนื่องจากไม่ชำระเงิน

5. การสนับสนุนและเป้าหมายการตอบสนอง

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

ความรุนแรง	คำอธิบาย	เป้าหมายการตอบสนองเริ่มต้น
Sev 1 — รุนแรงมาก	Partner API หยุดทำงานหรือใช้งานไม่ได้ในระบบจริงโดยไม่มีวิธีแก้ไขชั่วคราว	4 ชั่วโมง
Sev 2 — รุนแรงปานกลาง	ฟีเจอร์สำคัญทำงานผิดปกติหรือเสื่อมสภาพ มีวิธีแก้ไขชั่วคราว	1 วันทำการ
Sev 3 — เล็กน้อย	คำถามทั่วไป ปัญหาเล็กน้อย หรือคำขอฟีเจอร์	2 วันทำการ

เวลาตอบสนองเป้าหมายระบุเวลาที่ Wink ตั้งใจจะติดต่อ ครั้งแรก; ไม่ใช่การรับประกันเวลาการแก้ไข การสนับสนุนลำดับความสำคัญและเป้าหมายตามความรุนแรงใช้กับระดับที่ระบุว่าได้รับบริการนี้

6. ข้อมูลและความปลอดภัย

Wink รักษามาตรการบริหารจัดการ เทคนิค และองค์กรที่สมเหตุสมผลในเชิงพาณิชย์เพื่อปกป้องความลับ ความสมบูรณ์ และความพร้อมใช้งานของข้อมูลที่ประมวลผลผ่าน Partner API และทบทวนมาตรการเหล่านี้เป็นระยะ Wink ประมวลผลข้อมูลส่วนบุคคลตาม นโยบายความเป็นส่วนตัว และข้อกำหนดการประมวลผลข้อมูลในข้อตกลง คุณยังคงรับผิดชอบในการรักษาความปลอดภัยข้อมูลรับรอง API ของคุณ การใช้งานข้อมูลที่ถูกกฎหมาย และการแจ้ง Wink อย่างรวดเร็วหากสงสัยว่าข้อมูลรับรองถูกละเมิด

7. ข้อจำกัดความรับผิดชอบ

เครดิตบริการเป็น การเยียวยาเดียวและเฉพาะ สำหรับความไม่พร้อมใช้งานหรือความล้มเหลวในการปฏิบัติตามความมุ่งมั่นเวลาทำงาน และให้แทนความรับผิดชอบอื่นใดที่เกิดจากความล้มเหลวดังกล่าว เว้นแต่จะระบุไว้อย่างชัดเจนใน SLA นี้ Partner API ให้บริการในสภาพ “ตามที่มี” ในขอบเขตสูงสุดที่กฎหมายใช้บังคับ ความรับผิดชอบรวมของ Wink ที่เกิดขึ้นจากหรือเกี่ยวข้องกับบริการถูกจำกัดตามที่ระบุในข้อตกลง และ Wink จะไม่รับผิดชอบต่อความเสียหายทางอ้อม บังเอิญ พิเศษ ตามมา หรือเชิงลงโทษ หรือความเสียหายจากกำไร รายได้ ข้อมูล หรือชื่อเสียงที่สูญหาย แม้จะได้รับแจ้งถึงความเป็นไปได้ของความเสียหายดังกล่าวแล้วก็ตาม

8. ระยะเวลา การเปลี่ยนแปลง และการยกเลิก

SLA นี้ใช้บังคับตราบเท่าที่คุณมีการสมัครสมาชิก Partner API ที่ใช้งานอยู่ในระดับที่ระบุว่าใช้ SLA นี้ Wink อาจปรับปรุง SLA นี้เป็นครั้งคราว การเปลี่ยนแปลงที่สำคัญจะสื่อสารผ่านช่องทางที่ Wink ใช้สื่อสารกับลูกค้าเป็นประจำ และการใช้งาน Partner API ต่อหลังจากการอัปเดตมีผลถือเป็นการยอมรับ SLA ที่อัปเดตแล้ว SLA นี้จะสิ้นสุดโดยอัตโนมัติเมื่อข้อตกลงหรือการสมัครสมาชิก Partner API ของคุณสิ้นสุดหรือหมดอายุ ส่วนที่โดยธรรมชาติควรคงอยู่หลังการยกเลิก — รวมถึงสิทธิ์เครดิตบริการที่ยังไม่ได้เรียกร้อง ข้อจำกัดความรับผิดชอบ และคำจำกัดความ — จะยังคงมีผลต่อไป