Xác thực

​

Phương thức Xác thực

​

Xác thực bằng API Key

curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "X-API-Key: awx_your_api_key"

​

Biến môi trường

AGENTWALLEX_API_KEY=awx_your_api_key

import { AgentWallex } from "@agentwallex/sdk";

const aw = new AgentWallex({
  apiKey: process.env.AGENTWALLEX_API_KEY!,
});

import os
from agentwallex import AgentWallex

aw = AgentWallex(api_key=os.environ["AGENTWALLEX_API_KEY"])

​

Xác thực bằng JWT Bearer Token

GET /auth/google/redirect

GET /auth/google/callback

curl -X POST https://api.agentwallex.com/api/v1/auth/exchange \
  -H "Content-Type: application/json" \
  -d '{"exchange_code": "one_time_code"}'

curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "Authorization: Bearer eyJhbGciOi..."

​

Làm mới Token

curl -X POST https://api.agentwallex.com/api/v1/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{"refresh_token": "your_refresh_token"}'

​

Đăng xuất

curl -X POST https://api.agentwallex.com/api/v1/auth/logout \
  -H "Authorization: Bearer eyJhbGciOi..."

​

Các phương pháp Bảo mật tốt nhất

• Sử dụng biến môi trường — Không bao giờ mã hóa cứng khóa API trong mã nguồn.
• Xoay khóa thường xuyên — Xoay khóa API ít nhất mỗi 90 ngày. Xem Khóa API để biết hướng dẫn xoay khóa.
• Sử dụng phạm vi tối thiểu cần thiết — Tạo khóa API riêng biệt cho mỗi môi trường (sandbox và production).
• Bật danh sách IP cho phép — Có sẵn trên gói Growth và Enterprise để hạn chế truy cập API từ các IP đã biết.
• Giám sát nhật ký kiểm toán — Xem xét các sự kiện xác thực trong dashboard hoặc qua GET /audit-logs.
• Sử dụng sandbox cho phát triển — Không bao giờ thử nghiệm với khóa production hoặc quỹ thực.