Setup

Bài viết này sẽ chỉ cho bạn cách nhanh chóng trở thành nhà phát triển và bắt đầu thử nghiệm API của chúng tôi trên Wink.

:::lưu ý Kiểm tra luôn phải diễn ra trongmôi trường dàn dựng. Có ít dữ liệu hơn nhiều nhưng bạn có thể thoải mái thử nghiệm nhiều như bạn muốn mà không ảnh hưởng đến môi trường sản xuất.

Khi bạn đã sẵn sàng để hoạt động, chúng tôi sẽ chứng nhận tài khoản và ứng dụng của bạn và bạn có thể khởi chạy trong môi trường sản xuất của chúng tôi. :::

Thực hiện theo các bước sau:

Đăng ký tài khoản người dùng của bạn trên Wink
Tạo một tài khoản đại lý du lịch hoặc một tài khoản liên kết.
Tạo một ứng dụng nơi bạn liên kết nó với tài khoản bạn đã tạo ở Bước 2.
Một khi bạn đã tạo ra Application, lưu ID khách hàng và bí mật khách hàng ở nơi an toàn.

Mạng lưới phân phối nội địa

Tại Wink, chúng tôi sử dụng Cloudinary cho tất cả các tài sản hình ảnh và video của mình. Khi bạn truy cập vào kho lưu trữ du lịch của chúng tôi, bạn sẽ có toàn quyền truy cập vào tất cả các tính năng nâng cao của Cloudinary.

Của chúng tôi cloud_name là traveliko.

Mây mù

Ví dụ

Đối với mỗi loại hàng tồn kho du lịch mà chúng tôi hỗ trợ, sẽ có một mảng JSON lồng nhau được gọi làmultimedias. JSON cho mục nhập đa phương tiện trông như thế này:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Dòng được tô sáng ở trên hiển thị ID duy nhất của Cloudinarypartners/radisson_blu_logo. Đó là tất cả những gì bạn cần để lấy hình ảnh ở bất kỳ định dạng, chất lượng và kích thước nào bạn muốn.

Kiểm tra

Hãy đến với chúng tôiAPIvà chọn API bạn muốn làm việc.

Tài liệu API

Trang web tài liệu của chúng tôi được thiết lập theo cách cho phép bạn chạy lệnh API từ bên trong trang web.

Trong ví dụ này, bạn muốn sử dụngSearch Lookups (OAuth2)Gọi API.

:::tip[Mẹo chuyên nghiệp] Để dễ sử dụng, chúng tôi khuyên các nhà tích hợp sử dụng các điểm cuối mà chúng tôi chỉ định làOAuth2. Các điểm cuối đó biết mong đợi người gọi API và đã biết bạn đang sử dụng tài khoản nào nên bạn không cần phải chỉ địnhcompanyIdentifiertrong URL của bạn. :::

Sử dụng API tra cứu để lấy thông tin về điểm đến hoặc khách sạn.
Trong thanh điều hướng bên trái, nhấp vào Authentication.
Nhập ID khách hàng và bí mật khách hàng của bạn và nhấp vào Get TOKEN cái nút.
Nếu thông tin đăng nhập của bạn hợp lệ, bạn sẽ thấy khóa API của mình đã được áp dụng.
Bây giờ bạn có thể kiểm tra điểm cuối tra cứu.

Điểm cuối API tra cứu — *Tra cứu tìm kiếm mẫu (OAuth2)*

Người đưa thư

Bạn có thể làm điều tương tự với Postman.

Tải về Người đưa thư.
Nhấp vào Download OpenAPI spec từ đỉnh của API tra cứu trang.
Nhập nó vào Postman.
Nếu bạn nhập nó như một bộ sưu tập mới có tên là Wink API, nhấp vào dấu ba chấm ngang (3 chấm) bên cạnh tên bộ sưu tập và nhấp vào Edit.
Trong Authorization tab, thiết lập Auth type đến OAuth2.
Đặt trường Add auth data to ĐẾN Request headers.
Đặt trường Header prefix ĐẾN Bearer.
Đặt trường Token Name bất cứ tên nào bạn muốn đặt cho token đã lưu của mình trong Postman. Ví dụ: Wink Staging.
Đặt trường Grant type ĐẾN Client Credentials.
Đặt trường Access token URL tới https://staging-iam.wink.travel/oauth2/token.
Đặt trường Client ID đến ID khách hàng mà ứng dụng của bạn đã giúp tạo ra.
Đặt trường Client Secret đến Bí mật của khách hàng mà ứng dụng của bạn đã giúp tạo ra.
Đặt trường Scope ĐẾN inventory.read inventory.write inventory.remove. Đó là tất cả các phạm vi bạn cần cho Wink.
Đặt trường Client Authentication ĐẾN Send as Basic Auth header.
Nhấp vào Get New Access Token để lấy mã thông báo của bạn và lưu nó.
Đối với tất cả các lệnh gọi API trong bộ sưu tập API Wink, hãy đảm bảo tab xác thực ghi Inherit auth from parent vì vậy nó bao gồm mã thông báo của bạn với mỗi cuộc gọi.

:::tip[Pro Tip] Khuyến nghị biến miền máy chủ, ID máy khách và bí mật máy khách thành các biến môi trường. Theo cách đó, bạn có thể dễ dàng chuyển đổi giữa môi trường dàn dựng và môi trường sản xuất và sử dụng lại tất cả các hoạt động bạn đã tạo. :::