API REST trên nền tảng đám mây yêu cầu xác thực và các cuộc gọi không thể đến được cổng API. Không có tùy chọn nào để sử dụng xác thực cơ bản hoặc đơn giản là gửi lệnh mà không cần bất kỳ xác thực nào. Các cuộc gọi trái phép sẽ bị chặn bởi cổng xác thực và không được phép tiếp tục.
Token là gì?
Thay vì sử dụng tên người dùng và mật khẩu, API sử dụng mã truy cập (access token). Mã truy cập là một chuỗi dài các ký tự chữ và số, trông có vẻ vô nghĩa nhưng chứa thông tin quan trọng về người thực hiện các cuộc gọi API này và nơi chúng nên được gửi đến. Mã truy cập thường có dạng như sau:
Mã thông báo này chứa hai thông tin quan trọng.
- Tenant/Organization ID: Dành cho API biết không gian thuê (hoặc tổ chức) nào mà lệnh gọi này nên được gửi đến.
- User ID: Xác định danh tính người dùng đang thực hiện cuộc gọi.
Nếu thiếu thông tin này, mã thông báo sẽ bị từ chối và yêu cầu API sẽ bị trả về.
Thông tin này được tạo ra bởi nhà cung cấp định danh.
Bạn có thể tìm thấy mã thông báo ở đâu?
Bạn có thể tìm thấy mã thông báo trong giao diện đám mây, trong phần cài đặt profile hoặc phần Manage Cloud Account. Nếu không gian người thuê có gói đăng ký Tự động hóa, tùy chọn API sẽ xuất hiện ở cuối menu bên trái.
Những ứng dụng nào sử dụng mã thông báo?
Mặc dù tất cả các ứng dụng thực hiện cuộc gọi API cuối cùng đều sẽ sử dụng mã thông báo, nhưng chỉ các ứng dụng riêng tư như Insomnia hoặc Postman mới xác định rõ ràng mã thông báo. Vì các ứng dụng này không thể hiển thị hộp thoại đăng nhập BarTender Cloud, bạn cần chỉ định một bộ thông tin đăng nhập để tạo mã thông báo. Cụ thể hơn, bạn phải tạo một tài khoản người dùng để hoạt động như một dịch vụ và cấu hình xác thực dựa trên mật khẩu.
Đối với các ứng dụng web, giao diện tùy chỉnh được xây dựng để thực hiện các cuộc gọi và tương tác với API sử dụng các lệnh gọi để tạo hộp thoại đăng nhập. Về cơ bản, điều này tạo ra một mã thông báo truy cập sau khi nhà cung cấp danh tính xác minh danh tính của người dùng và hoạt động tương tự như bất kỳ lệnh gọi nào khác đến API.
Lưu ý đặc biệt về Local Printers and Tokens
Để sử dụng máy in trên một hệ thống máy khách cụ thể, máy khách phải đăng nhập vào đám mây ít nhất một lần để thiết lập kết nối. Cấu hình này được thực hiện tự động nếu bạn cài đặt Print Gateway từ hộp thoại in trong chính đám mây.
Nếu bạn cài đặt Print Gateway thông qua trình cài đặt chứ không phải từ hộp thoại in trên đám mây, bạn sẽ cần đăng nhập vào đám mây ít nhất một lần và mở hộp thoại in để cấu hình Print Gateway.
Thao tác này sẽ khiến BarTender Cloud giao tiếp với Print Gateway được cài đặt cục bộ và tự động điền vào trường mã thông báo.
Mã thông báo đặc biệt này nằm ở đầu phần cài đặt Print Gateway.
Lấy Bearer Token bằng ứng dụng
Nếu bạn đang sử dụng ứng dụng gửi email như Insomnia hoặc Postman, hãy đảm bảo sử dụng URL sau khi truy vấn nhà cung cấp định danh nâng cao của BarTender để lấy mã thông báo bearer:
https://auth.am1.bartendercloud.com/connect/token?OrganizationDnsName=(organizationIdentifier)
Thay vì (organizationidentifier) , hãy sử dụng ID Miền Tổ chức của bạn.
Tổng kết
Vậy là tôi vừa giới thiệu xong cho bạn Xác thực và mã thông báo API REST của BarTender Cloud. Nếu gặp bất kỳ khó khăn nào trong quá trình thực hiện, bạn có thể liên hệ banquyenphanmem.com hoặc gọi số 028.22443013 để được trợ giúp. Với các hướng dẫn trên, chúng tôi hy vọng bạn đã giải quyết được nhu cầu của mình một cách nhanh chóng và hiệu quả.
