Sử dụng mã thông báo truy cập

Token truy cập cho phép các yêu cầu gửi đến API Altium 365 được xác thực. Bạn đưa token này vào mọi yêu cầu dưới dạng bearer token trong tiêu đề Authorization.

Có thể lấy token truy cập theo hai cách:

• Directly – khi bạn tạo token truy cập dài hạn trong Admin → Developer

• Via exchange – khi bạn dùng token làm mới để tạo token truy cập ngắn hạn (token này sẽ không được liệt kê trong Admin → Developer)

Cách thức xác thực là như nhau, bất kể token được lấy bằng cách nào.

Tiêu đề xác thực

Authorization: Bearer {access-token}

Ví dụ: curl

curl -X POST https://{workspace-domain}/api/graphql/ \
  -H "Authorization: Bearer {access-token}" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ desProjects(first: 5) { nodes { id name } } }"}'

Thời hạn token

Long-lived access tokens hết hạn sau thời gian hiệu lực bạn đã cấu hình khi tạo (tối đa 1 năm). Sau khi hết hạn, bạn cần tạo token mới trong Admin → Developer.

Short-lived access tokens (được lấy bằng cách trao đổi token làm mới) hết hạn sau một khoảng thời gian ngắn. Khi đó, hãy trao đổi token làm mới một lần nữa để lấy token truy cập mới – xem Sử dụng token làm mới.

Token hết hạn khiến các yêu cầu API trả về 401 Unauthorized, hoặc 200 OK với mã lỗi AuthExpiredToken trong phản hồi GraphQL.

Bảo mật

• Không nhúng token truy cập vào mã phía máy khách hoặc đưa chúng vào hệ thống quản lý mã nguồn.

• Đối với các tích hợp tự động chạy trong thời gian dài, nên ưu tiên sử dụng token làm mới – token truy cập ngắn hạn giúp giới hạn khoảng thời gian có thể bị khai thác nếu token bị lộ.

Xem thêm

• Sử dụng token làm mới