인증

​

인증 방법

​

API 키 인증

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

​

환경 변수

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"])

​

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..."

​

토큰 갱신

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

​

로그아웃

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

​

보안 모범 사례

• 환경 변수 사용 — 소스 코드에 API 키를 하드코딩하지 마세요.
• 키를 정기적으로 교체 — 최소 90일마다 API 키를 교체하세요. 교체 방법은 API 키를 참조하세요.
• 필요한 최소 범위 사용 — 환경별(샌드박스 vs. 프로덕션)로 별도의 API 키를 생성하세요.
• IP 허용 목록 활성화 — Growth 및 Enterprise 플랜에서 알려진 IP로 API 접근을 제한할 수 있습니다.
• 감사 로그 모니터링 — 대시보드 또는 GET /audit-logs를 통해 인증 이벤트를 검토하세요.
• 개발에는 샌드박스 사용 — 프로덕션 키나 실제 자금으로 테스트하지 마세요.