API Đối tác

API Đối tác Wink 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 lưu trữ 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 duyệt công khai, đượ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 duyệt công khai dành cho nhúng nhẹ, hướng đến người dùng, API Đối tác đượ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ả cho lưu lượng bạn thực sự gửi.

Gói & giá cả

Mức sử dụng được đo bằng đêm khách sạn: một khách sạn được định giá cho một đêm lưu trú — không phải một lần gọi API. Một tìm kiếm trả về 20 khách sạn cho 3 đêm lưu trú là 60 đêm khách sạn từ một yêu cầu duy nhất. Các cuộc gọi Nội dung và Tra cứu (tìm kiếm điểm đến và tự động hoàn thành) là ngoại lệ: mỗi cuộc gọi tính một đơn vị, bất kể trả về bao nhiêu. Các điểm cuối tài khoản là miễn phí. Giá cả là nguồn chính xác cho mức giá.

	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	Thông lượng trả theo mức sử dụng quy mô lớn	Khối lượng tùy chỉnh & điều khoản thương lượng
Đơn vị 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 đơn vị (đêm khách sạn)	Miễn phí	$0.0001	Tùy chỉnh
Phản hồi khi đạt hạn mức hàng tháng	429 cho đến ngày 1 tháng sau (UTC)	Tính phí, không chặn	Theo thỏa thuận
Thỏa thuận Cấp độ Dịch vụ	—	✓	✓
Hỗ trợ ưu tiên	—	✓	✓
Hỗ trợ khởi tạo riêng	—	—	✓

Nhận 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 phục vụ kho lưu trữ có thể đặt được, tương ứng với hai cấp trên:

• Miễn phí — API Người tiêu dùng / Động cơ Đặt chỗ (REST, /api/public/**): ẩn danh, hướng trình duyệt và widget. Duyệt tham khảo Động cơ Đặt chỗ →
• Trả phí — API Đối tác Tích hợp (gRPC, wink.partner.v1): xác thực, đo 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 Tích hợp viên →

API Đối tác Tích hợp là gRPC, không phải REST. Bạn gọi nó bằng client được tạo tự động qua HTTP/2 tại partner.wink.travel:443, truyền token bearer và tài khoản bạn gọi cho:

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

Trang tham khảo trên tài liệu mọi dịch vụ, thông điệp và trạng thái lỗi, và schema cũng có sẵn tại thời gian chạy qua phản chiếu máy chủ, nên grpcurl, Postman và Insomnia có thể khám phá mà không cần tải xuống.

Nếu bạn muốn tạo client trước, các tệp nguồn .proto được công bố tại github.com/wink-travel/partner-api-proto.

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 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í.

• Không giới hạn công bố theo phút. Wink giám sát tốc độ yêu cầu và có thể áp dụng giới hạn sử dụng công bằng để bảo vệ dịch vụ. Nếu bạn nhận được HTTP 429 (Quá nhiều yêu cầu), hãy chờ số giây trong tiêu đề Retry-After trước khi thử lại.
• Hạn mức hàng tháng — 10.000 đơn vị mỗi tháng dương lịch. Hạn mức được cấp theo tài khoản và đặt lại vào ngày 1 mỗi tháng (UTC). Khi đạt hạn mức, tài khoản chưa đăng ký thanh toán theo mức sử dụng sẽ nhận HTTP 429 cho đến ngày 1 tháng sau — dừng cứng, kèm tiêu đề Retry-After và thông báo mời bạn đăng ký gói Trả phí. Tài khoản đã đăng ký tiếp tục hoạt động và bị tính phí cho mức sử dụng vượt hạn mức.

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à chỉ tính phí bạn cho những gì bạn sử dụng.

• Đêm khách sạn đo mức — $0.0001 mỗi đêm khách sạn. Không có giới hạn hàng tháng; bạn bị tính phí theo khối lượng thực tế. Wink vẫn có thể áp dụng giới hạn sử dụng công bằng để bảo vệ dịch vụ. Các cuộc gọi tìm kiếm và kho lưu trữ tính phí theo đêm khách sạn được định giá; các cuộc gọi Nội dung và Tra cứu tính một đơn vị mỗi lần, nên gom nhóm yêu cầu giúp giảm hóa đơn.

Cấp trả phí bao gồm Thỏa thuận Cấp độ Dịch vụ 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 (“SLA”) quy định cam kết về 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 API Đối tác Wink đã xác thực (“API Đối tác” hoặc “Dịch vụ”) trên các cấp có SLA á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 API Đối tác (“Thỏa thuận”), và áp dụng miễn là bạn duy trì đăng ký API Đối tác trả phí hợp lệ. 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

1. “Thời gian hoạt động” nghĩa là các khoảng thời gian API Đối tác có thể nhận và phản hồi thành công các yêu cầu được định dạng đúng và xác thực.
2. “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 đó API Đối tác không phản hồi thành công các yêu cầu được định dạng đúng và xác thực, không tính các khoảng thời gian thuộc các loại 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.
3. “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.
4. “Bảo trì theo lịch trình” nghĩa là bảo trì dịch vụ được lên kế hoạch mà Wink đã thông báo trước theo Mục 4.
5. “Tín dụng Dịch vụ” nghĩa là tín dụng, tính theo phần trăm phí bạn đã trả hoặc phải trả cho API Đối tác trong tháng dương lịch bị ảnh hưởng, được áp dụng vào các khoản phí API Đối tác trong tương lai như biện pháp duy nhất và độc quyền cho việc không đạt cam kết Thời gian hoạt động.
6. “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 định dạng đúng và xác thực tại ranh giới dịch vụ của Wink đến thời điểm Wink bắt đầu trả 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 Khả dụng & Hiệu suất

Wink sẽ sử dụng nỗ lực hợp lý về mặt thương mại để đảm bảo API Đối tác 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ố 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 xá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ị 95 (P95) dưới 500 mili giây cho các yêu cầu thành công, được định dạng đúng và xác thực, đ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ả lỗi cấp ứng dụng do chính yêu cầu gây ra, và các yêu cầu nhóm 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 việc không đạt Cam kết Thời gian hoạt động và là biện pháp duy nhất và độc quyền cho các thiếu hụt về 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ụ tính theo phần trăm phí API Đối tác 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%

1. 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ợ nào có thể có. Yêu cầu gửi sau thời hạn này sẽ không được chấp nhận.
2. 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í API Đối tác 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.
3. 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í API Đối tác bạn đã trả hoặc phải trả cho tháng đó.
4. Biện pháp duy nhất và độc quyền. Tín dụng Dịch vụ là biện pháp duy nhất và độc quyền 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 khả dụng nào khác của API Đối tác.

4. 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:

1. 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 hợp lý qua kênh mà Wink thường dùng để liên lạc với khách hàng;
2. 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;
3. 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;
4. 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 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à
5. 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 API Đối tác 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 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	API Đối tác 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 — Chính	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ệ lần đầ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 xử lý qua API Đối tác, và xem xét các biện pháp đó định kỳ. Việc Wink xử lý dữ liệu cá nhân đượ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 duy nhất và độc quyền cho bất kỳ sự không khả dụng hoặ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 không đạt đó. Ngoại trừ những gì được nêu rõ trong SLA này, API Đối tác được cung cấp theo dạng “có sẵn”. Trong phạm vi tối đa cho phép của pháp 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ụ bị 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 cảnh 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ý API Đối tác hoạt động trên cấp có ghi rõ SLA á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 API Đối tác 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ý API Đối tác của bạn hết hạn hoặc bị chấm dứt. Các phần 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 còn hiệu lực.