API

Get started

Bắt đầu

Xác thực

Một số thao tác của API này có thể truy cập công khai và không yêu cầu xác thực. Tuy nhiên, tất cả các thao tác ảnh hưởng đến tài khoản của bạn đều yêu cầu personal access token (PAT) hoặc OAuth authentication khi sử dụng ứng dụng bên thứ ba.

Personal Access Tokens

Cách dễ nhất để truy cập API là sử dụng personal access token (PAT) được tạo từ cổng Cloud Manager của Akamai. Token này chỉ nên có quyền truy cập cần thiết cho ứng dụng.

Cách tạo PAT

  1. Đăng nhập Cloud Manager.
  2. Nhấn vào tên hồ sơ của bạn ở góc trên bên phải và chọn API Tokens.
  3. Nhấp Create a Personal Access Token. Bảng tạo PAT xuất hiện..
  4. Điền Label, Expiry, Access.
  5. Nhấp Create Token. Token chỉ hiển thị một lần.
📘 Lưu token ở nơi an toàn, không thể xem lại sau khi đóng.

PAT authentication

Security Scheme TypeHTTP
Authorization SchemeBearer

Scopes OAuth cũng áp dụng cho PAT.

Thu hồi PAT

Đăng nhập Cloud Manager → My Profile → API Tokens, chọn token → Revoke.

OAuth

Nếu ứng dụng cần cho người dùng bất kỳ đăng nhập, hãy dùng OAuth 2.0.

👍 Nếu chỉ dùng cá nhân, hãy dùng PAT.

Trước khi bắt đầu

  • Tạo OAuth client để lấy client_id, client_secret.
  • Private client dùng cho app bảo mật, Public client dùng cho app không thể giữ bí mật.
  • redirect_uri là Callback URL.

Luồng Private (Authorization Code)

  1. User đăng nhập qua login.linode.com.
  2. Server trả về code qua redirect.
  3. App POST tới /oauth/token với code, client_id, secret.
  4. Nhận access_token (2h) và refresh_token.
  5. Dùng access_token cho API call.
  6. Khi hết hạn, dùng refresh_token để lấy token mới.

Luồng Public (Implicit)

User đăng nhập và nhận access_token qua URL hash (2h). Không có refresh_token, cần login lại sau khi hết hạn.

OAuth reference

Authorization URL: https://login.linode.com/oauth/authorize
Token URL: https://login.linode.com/oauth/token

Scopes

ScopeMô tả
account:read_onlyXem thông tin tài khoản
account:read_writeQuản lý tài khoản
linodes:read_onlyXem Linodes
linodes:read_writeQuản lý Linodes
domains:read_onlyXem tên miền
domains:read_writeQuản lý tên miền
images:read_onlyXem images
images:read_writeQuản lý images
firewall:read_onlyXem firewalls
firewall:read_writeQuản lý firewalls
object_storage:read_onlyXem Object Storage
object_storage:read_writeQuản lý Object Storage
vpc:read_writeQuản lý VPC và subnet

Xác thực Monitor API

  1. Gọi List supported services → lấy service_type.
  2. Gọi List cho service → lấy id.
  3. Gọi Create a token với service_type và entity_id → lưu token.
  4. Gọi Get metrics với Bearer token.
curl --request POST \
     --url https://monitor-api.linode.com/v1/monitor/services/dbaas/metrics \
     --header 'accept: application/json' \
     --header 'authorization: Bearer abc123' \
     --header 'content-type: application/json' \
     --data '{"aggregate_function":"min"}'
Trích dẫn bài viết gốc: Get started – Akamai TechDocs