Khóa API

​

Tổng quan

​

Tạo Khóa API

​

Qua Dashboard

1. Đăng nhập vào AgentWallex Dashboard.
2. Điều hướng đến Settings > API Keys.
3. Nhấp Create API Key.
4. Đặt tên mô tả cho khóa (ví dụ: production-backend, staging-ci).
5. Sao chép và lưu trữ khóa an toàn — nó chỉ được hiển thị một lần.

​

Qua API

curl -X POST https://api.agentwallex.com/api/v1/api-keys \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{"name": "production-backend"}'

​

Liệt kê Khóa API

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

{
  "data": [
    {
      "id": "key_abc123",
      "name": "production-backend",
      "prefix": "awx_...x4f2",
      "created_at": "2025-06-01T10:00:00Z",
      "last_used_at": "2025-06-15T14:30:00Z"
    }
  ]
}

​

Xoay Khóa API

curl -X DELETE https://api.agentwallex.com/api/v1/api-keys/key_abc123 \
  -H "Authorization: Bearer eyJhbGciOi..."

​

Giới hạn Tốc độ

{
  "code": "rate_limit_exceeded",
  "type": "rate_limit_error",
  "message": "Rate limit exceeded. Retry after 30 seconds."
}

​

Các phương pháp tốt nhất

• Một khóa cho mỗi môi trường — Sử dụng khóa riêng biệt cho development, staging và production.
• Đặt tên khóa mô tả — Bao gồm tên môi trường và dịch vụ (ví dụ: prod-payment-service).
• Giám sát việc sử dụng — Kiểm tra last_used_at để xác định các khóa không sử dụng cần được xóa.
• Không bao giờ chia sẻ khóa — Mỗi thành viên nhóm hoặc dịch vụ nên có khóa riêng.
• Sử dụng trình quản lý bí mật — Lưu trữ khóa trong AWS Secrets Manager, HashiCorp Vault hoặc các công cụ tương tự thay vì trong tệp .env trên đĩa.