Partner API

Wink Partner API là cách xác thực, có thông lượng cao hơn để các nhà tích hợp truy vấn kho du lịch có thể đặt được — cùng nguồn cung cấp vận hành các widget nhúng và các điểm cuối duyệt công khai của chúng tôi, được cung cấp như một giao diện lập trình chính thức. Trong khi các Web Components miễn phí và các điểm cuối duyệt công khai dành cho việc nhúng nhẹ, hướng đến người dùng, Partner API được xây dựng cho các hệ thống tìm kiếm, định giá và đặt chỗ ở quy mô lớn. Truy cập được xác thực theo từng nhà tích hợp và tính phí theo mức sử dụng, vì vậy bạn chỉ trả tiền cho lưu lượng bạn thực sự gửi.

Các gói & giá cả

Một cuộc gọi API = một yêu cầu. Mức sử dụng được đo lường và tính phí theo mỗi 1.000 yêu cầu.

	Miễn phí	Trả phí	Doanh nghiệp
Giá	$0	Tính theo mức sử dụng	Liên hệ chúng tôi
Phù hợp nhất cho	Đánh giá & tích hợp khối lượng thấp	Thanh toán theo lưu lượng sử dụng ở quy mô lớn	Khối lượng tùy chỉnh & điều khoản thương lượng
Yêu cầu mỗi phút	30 (bùng phát 60)	Không giới hạn	Không giới hạn
Yêu cầu mỗi tháng	10.000	Không giới hạn	Không giới hạn
Thời gian phản hồi API (P95)	—	Dưới 500 ms	Dưới 500 ms
Giá mỗi 1.000 yêu cầu	Miễn phí	$1.00	Tùy chỉnh
Phí vượt tỷ lệ look-to-book (mỗi 1.000 lượt xem vượt quá tỷ lệ 5.000:1)	—	$2.00	Tùy chỉnh
Phản hồi giới hạn tỷ lệ	429 (tạm dừng / dừng cứng hàng tháng)	Không	Không
Thỏa thuận Cấp độ Dịch vụ	—	✓	✓
Hỗ trợ ưu tiên	—	✓	✓
Hướng dẫn riêng biệt	—	—	✓

Lấy khóa API · Bắt đầu thanh toán theo mức sử dụng · Liên hệ bộ phận bán hàng

Tham khảo API

Hai giao diện OpenAPI phục vụ kho có thể đặt được, và chúng tương ứng với hai cấp độ trên:

Miễn phí — Consumer / Booking Engine API (/api/public/**): ẩn danh, hướng đến trình duyệt và widget. Duyệt tham khảo Booking Engine →
Trả phí — Partner Integrator API (/api/partner/**): xác thực, đo lường mức sử dụng, xây dựng cho tích hợp máy chủ với máy chủ ở quy mô lớn. Duyệt tham khảo Integrator →

Cách hoạt động của mức sử dụng và giới hạn

Cấp miễn phí

Cấp miễn phí được thiết kế để bạn có thể xây dựng, thử nghiệm và vận hành lưu lượng sản xuất vừa phải mà không mất phí.

Giới hạn tỷ lệ — 30 yêu cầu mỗi phút, với bùng phát 60 yêu cầu. Các đỉnh ngắn vượt mức duy trì được hấp thụ bởi hạn mức bùng phát. Nếu vượt quá, API sẽ trả về HTTP 429 (Quá nhiều yêu cầu) và áp dụng tạm dừng 5 phút trước khi khóa của bạn tiếp tục phục vụ lưu lượng. Hãy giảm tốc và thử lại sau khi hết thời gian tạm dừng thay vì liên tục gửi yêu cầu.
Hạn mức hàng tháng — 10.000 yêu cầu mỗi tháng dương lịch. Khi đạt đến giới hạn hàng tháng, API trả về HTTP 429 trong phần còn lại của tháng — một dừng cứng — kèm theo thông báo mời bạn đăng ký cấp Trả phí để tiếp tục. Bộ đếm được đặt lại vào đầu tháng dương lịch tiếp theo.

Cấp miễn phí không bao gồm Thỏa thuận Cấp độ Dịch vụ hay hỗ trợ ưu tiên.

Cấp trả phí

Cấp trả phí loại bỏ giới hạn hàng tháng và tạm dừng giới hạn tỷ lệ, và chỉ tính phí bạn theo mức sử dụng thực tế.

Yêu cầu đo lường — $1.00 cho mỗi 1.000 yêu cầu. Không có giới hạn yêu cầu hàng tháng và không có giới hạn tỷ lệ dưới mức sử dụng bình thường; bạn được tính phí theo khối lượng thực tế.
Phí vượt tỷ lệ look-to-book — $2.00 cho mỗi 1.000 lượt xem vượt mức. Để giữ nguồn cung khỏe mạnh, chúng tôi đo tỷ lệ giữa lượt tìm kiếm (“lượt xem”) và đặt chỗ xác nhận. Bạn được phép 5.000 lượt xem cho mỗi đặt chỗ trước khi phí vượt mức được áp dụng. Lượt xem vượt mức được tính như sau:

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

Phí vượt mức sau đó được tính là $2.00 cho mỗi 1.000 lượt xem vượt mức. Các tích hợp có tỷ lệ chuyển đổi tốt hiếm khi bị phí vượt mức; phí chỉ áp dụng cho lưu lượng tìm kiếm nhiều hơn rất nhiều so với đặt chỗ.

Cấp trả phí bao gồm Thỏa thuận Cấp độ Dịch vụ được mô tả bên dưới — cam kết thời gian hoạt động 99,9% và mục tiêu thời gian phản hồi P95 dưới 500 ms — cùng hỗ trợ ưu tiên theo mức độ nghiêm trọng.

Thỏa thuận Cấp độ Dịch vụ

Ngày hiệu lực: 5 tháng 7 năm 2026 · Phiên bản 1.0

Thỏa thuận Cấp độ Dịch vụ này (gọi tắt là “SLA”) quy định cam kết về tính khả dụng, tín dụng dịch vụ và mục tiêu hỗ trợ mà Wink (“Wink”, “chúng tôi”) cung cấp cho khách hàng (“Khách hàng”, “bạn”) đối với Partner API của Wink có xác thực (gọi tắt là “Partner API” hoặc “Dịch vụ”) ở các cấp có SLA được áp dụng. SLA này được tích hợp và điều chỉnh bởi thỏa thuận giữa bạn và Wink mà theo đó bạn truy cập Partner API (gọi tắt là “Thỏa thuận”), và áp dụng miễn là bạn duy trì đăng ký Partner API trả phí còn hiệu lực. Các thuật ngữ viết hoa không được định nghĩa ở đây có nghĩa như trong Thỏa thuận.

1. Định nghĩa

“Thời gian hoạt động” nghĩa là các khoảng thời gian Partner API có thể nhận và phản hồi thành công các yêu cầu được xác thực và đúng định dạng.
“Thời gian ngưng hoạt động” nghĩa là bất kỳ khoảng thời gian nào, tính bằng phút, trong đó Partner API không phản hồi thành công các yêu cầu được xác thực và đúng định dạng, không tính các khoảng thời gian thuộc các trường hợp loại trừ được nêu tại Mục 4. Các lỗi riêng lẻ ảnh hưởng đến một phần nhỏ yêu cầu không được tính là Thời gian ngưng hoạt động.
“Tỷ lệ Thời gian hoạt động hàng tháng” nghĩa là, trong một tháng dương lịch nhất định, tổng số phút trong tháng đó trừ đi tổng số phút Thời gian ngưng hoạt động, chia cho tổng số phút trong tháng đó, biểu thị dưới dạng phần trăm.
“Bảo trì theo lịch trình” nghĩa là bảo trì Dịch vụ đã được Wink thông báo trước theo Mục 4.
“Tín dụng Dịch vụ” nghĩa là tín dụng, được tính theo phần trăm phí bạn đã trả hoặc phải trả cho Partner API trong tháng dương lịch bị ảnh hưởng, được áp dụng vào các khoản phí Partner API trong tương lai như biện pháp khắc phục duy nhất và cuối cùng cho việc không đạt cam kết Thời gian hoạt động.
“Thời gian phản hồi” nghĩa là thời gian trôi qua từ khi Wink nhận được yêu cầu được xác thực và đúng định dạng tại ranh giới dịch vụ của Wink đến khi Wink bắt đầu trả về phản hồi, không tính thời gian truyền mạng và bất kỳ thời gian phía khách hàng nào ngoài tầm kiểm soát của Wink.

2. Cam kết Tính khả dụng & Hiệu suất

Wink sẽ sử dụng các nỗ lực hợp lý về mặt thương mại để đảm bảo Partner API có Tỷ lệ Thời gian hoạt động hàng tháng ít nhất 99,9% trong mỗi tháng dương lịch của thời hạn (gọi là “Cam kết Thời gian hoạt động”). Cam kết Thời gian hoạt động được đo tại ranh giới dịch vụ của Wink và không bao gồm các yếu tố ngoài tầm kiểm soát hợp lý của Wink, bao gồm các yếu tố được mô tả tại Mục 4. Hệ thống giám sát của Wink là nguồn dữ liệu chính thức để đo Tỷ lệ Thời gian hoạt động hàng tháng và Thời gian phản hồi.

Wink cũng đặt mục tiêu Thời gian phản hồi bách phân vị thứ 95 (P95) dưới 500 mili giây cho các yêu cầu thành công, được xác thực và đúng định dạng, đo tại ranh giới dịch vụ của Wink trong mỗi tháng dương lịch (gọi là “Mục tiêu Hiệu suất”). Mục tiêu Hiệu suất không bao gồm các yếu tố mô tả tại Mục 4, các yêu cầu trả về lỗi cấp ứng dụng do chính yêu cầu gây ra, và các yêu cầu hàng loạt lớn hoặc phức tạp bất thường. Mục tiêu Hiệu suất là mục tiêu dịch vụ; Tín dụng Dịch vụ tại Mục 3 áp dụng cho các trường hợp không đạt Cam kết Thời gian hoạt động và là biện pháp khắc phục duy nhất và cuối cùng cho các thiếu hụt về tính khả dụng.

3. Tín dụng Dịch vụ

Nếu Tỷ lệ Thời gian hoạt động hàng tháng thấp hơn Cam kết Thời gian hoạt động trong bất kỳ tháng dương lịch nào, bạn có thể đủ điều kiện nhận Tín dụng Dịch vụ được tính theo phần trăm phí Partner API bạn đã trả hoặc phải trả cho tháng đó, theo bảng sau:

Tỷ lệ Thời gian hoạt động hàng tháng	Tín dụng Dịch vụ
Dưới 99,9% nhưng từ 99,0% trở lên	10%
Dưới 99,0% nhưng từ 95,0% trở lên	25%
Dưới 95,0%	50%

Yêu cầu tín dụng. Để nhận Tín dụng Dịch vụ, bạn phải gửi yêu cầu bằng văn bản cho Wink trong vòng ba mươi (30) ngày kể từ khi kết thúc tháng dương lịch xảy ra thiếu hụt. Yêu cầu phải bao gồm ngày giờ của từng sự cố Thời gian ngưng hoạt động bạn yêu cầu và bất kỳ nhật ký hoặc bằng chứng hỗ trợ hợp lý nào bạn có. Yêu cầu gửi sau thời hạn này sẽ không được chấp nhận.
Hình thức tín dụng. Tín dụng Dịch vụ được phê duyệt sẽ được áp dụng vào các khoản phí Partner API trong tương lai và không có giá trị tiền mặt. Chúng không phải là khoản hoàn tiền và sẽ không được thanh toán trừ khi luật áp dụng yêu cầu.
Tín dụng tối đa. Tổng Tín dụng Dịch vụ được cấp cho bất kỳ tháng dương lịch nào sẽ không vượt quá 50% phí Partner API bạn đã trả hoặc phải trả cho tháng đó.
Biện pháp khắc phục duy nhất và cuối cùng. Tín dụng Dịch vụ là biện pháp khắc phục duy nhất và cuối cùng của bạn đối với bất kỳ việc Wink không đạt Cam kết Thời gian hoạt động hoặc bất kỳ thiếu hụt tính khả dụng nào khác của Partner API.

4. Các trường hợp loại trừ

Cam kết Thời gian hoạt động và bất kỳ Tín dụng Dịch vụ nào phát sinh không áp dụng cho, và Thời gian ngưng hoạt động không bao gồm, bất kỳ sự không khả dụng, đình chỉ, suy giảm hoặc vấn đề hiệu suất nào phát sinh từ hoặc liên quan đến:

Bảo trì theo lịch trình mà Wink đã thông báo trước, với điều kiện thông báo được gửi trước một khoảng thời gian hợp lý qua kênh mà Wink thường dùng để liên lạc với khách hàng;
các sự kiện bất khả kháng hoặc nguyên nhân khác ngoài tầm kiểm soát hợp lý của Wink, bao gồm thiên tai, hành động của chính phủ, sự cố mạng hoặc tiện ích, và các cuộc tấn công từ chối dịch vụ hoặc các cuộc tấn công độc hại khác;
các vấn đề do hành động hoặc thiếu sót của bạn, thiết bị, phần mềm hoặc mạng của bạn, hoặc do bất kỳ dịch vụ, sản phẩm hoặc nhà cung cấp bên thứ ba nào không thuộc quyền kiểm soát trực tiếp của Wink;
việc lạm dụng Dịch vụ hoặc vi phạm Thỏa thuận, SLA này, các điều khoản sử dụng chấp nhận được, hoặc các giới hạn tỷ lệ áp dụng, bao gồm lưu lượng mà Wink xác định hợp lý là quá mức, lạm dụng tự động hoặc gian lận; và
bất kỳ đình chỉ hoặc chấm dứt quyền truy cập của bạn được thực hiện đúng theo Thỏa thuận, bao gồm đình chỉ do không thanh toán.

5. Hỗ trợ & Mục tiêu phản hồi

Wink cung cấp hỗ trợ cho Partner API trong giờ làm việc tiêu chuẩn, không bao gồm các ngày lễ địa phương. Wink sẽ sử dụng các nỗ lực hợp lý về mặt thương mại để xác nhận các yêu cầu hỗ trợ được gửi đúng cách trong các thời gian phản hồi mục tiêu sau, dựa trên mức độ nghiêm trọng bạn gán và Wink xác nhận hợp lý:

Mức độ nghiêm trọng	Mô tả	Mục tiêu phản hồi ban đầu
Sev 1 — Quan trọng	Partner API ngưng hoạt động hoặc không thể sử dụng trong sản xuất và không có giải pháp thay thế.	4 giờ
Sev 2 — Lớn	Tính năng quan trọng bị suy giảm hoặc hỏng; có giải pháp thay thế.	1 ngày làm việc
Sev 3 — Nhỏ	Câu hỏi chung, vấn đề nhỏ hoặc yêu cầu tính năng.	2 ngày làm việc

Thời gian phản hồi mục tiêu mô tả khi Wink dự kiến sẽ liên hệ ban đầu; không phải là cam kết về thời gian giải quyết. Hỗ trợ ưu tiên và mục tiêu theo mức độ nghiêm trọng áp dụng cho các cấp có ghi rõ bao gồm.

6. Dữ liệu & Bảo mật

Wink duy trì các biện pháp hành chính, kỹ thuật và tổ chức hợp lý về mặt thương mại nhằm bảo vệ tính bảo mật, toàn vẹn và khả dụng của dữ liệu được xử lý qua Partner API, và xem xét các biện pháp đó định kỳ. Việc xử lý dữ liệu cá nhân của Wink được điều chỉnh bởi Chính sách Bảo mật và bất kỳ điều khoản xử lý dữ liệu nào trong Thỏa thuận. Bạn chịu trách nhiệm bảo mật thông tin xác thực API của mình, việc sử dụng hợp pháp bất kỳ dữ liệu nào bạn truy xuất, và thông báo kịp thời cho Wink về bất kỳ nghi ngờ nào về việc lộ thông tin xác thực.

7. Giới hạn trách nhiệm

Tín dụng Dịch vụ là biện pháp khắc phục duy nhất và cuối cùng cho bất kỳ sự không khả dụng hoặc việc không đạt Cam kết Thời gian hoạt động nào, và được cung cấp thay cho bất kỳ trách nhiệm nào khác phát sinh từ việc đó. Ngoại trừ những điều được nêu rõ trong SLA này, Partner API được cung cấp theo dạng “có sẵn”. Trong phạm vi tối đa cho phép bởi luật áp dụng, trách nhiệm tổng hợp của Wink phát sinh từ hoặc liên quan đến Dịch vụ được giới hạn như trong Thỏa thuận, và Wink không chịu trách nhiệm đối với bất kỳ thiệt hại gián tiếp, ngẫu nhiên, đặc biệt, hậu quả hoặc trừng phạt nào, hoặc mất lợi nhuận, doanh thu, dữ liệu hoặc uy tín, ngay cả khi đã được thông báo về khả năng xảy ra các thiệt hại đó.

8. Thời hạn, Thay đổi & Chấm dứt

SLA này áp dụng miễn là bạn có đăng ký Partner API còn hiệu lực ở cấp có ghi rõ SLA được áp dụng. Wink có thể cập nhật SLA này theo thời gian; các thay đổi quan trọng sẽ được thông báo qua kênh mà Wink thường dùng để liên lạc với khách hàng, và việc tiếp tục sử dụng Partner API sau khi cập nhật có hiệu lực đồng nghĩa với việc bạn chấp nhận SLA đã cập nhật. SLA này tự động chấm dứt khi Thỏa thuận hoặc đăng ký Partner API của bạn hết hạn hoặc bị chấm dứt. Các mục theo bản chất nên tồn tại sau khi chấm dứt — bao gồm quyền nhận Tín dụng Dịch vụ chưa yêu cầu, giới hạn trách nhiệm và định nghĩa — vẫn tiếp tục có hiệu lực.