Authentication

EZYS API 인증 방법을 설명합니다.

---

API Key

모든 API 요청에는 API Key가 필요합니다.

Header

X-API-Key: ezys_live_sk_xxxxxxxxxxxxx

Example

curl -X GET "https://api.ezys.io/v1/pairs" \
  -H "X-API-Key: ezys_live_sk_xxxxx"

---

API Key 형식

Environment	Prefix	Example
Production	ezys_live_sk_	ezys_live_sk_a1b2c3d4e5f6...
Sandbox	ezys_test_sk_	ezys_test_sk_a1b2c3d4e5f6...

---

API Key 발급

1. EZYS 팀에 연동 요청 ([email protected])

2. 계약 및 KYB 완료

3. API Key 발급

---

환경 변수 사용 예시

Node.js

// .env
EZYS_API_KEY=ezys_live_sk_xxxxx

// app.js
const apiKey = process.env.EZYS_API_KEY;

const response = await fetch('https://api.ezys.io/v1/pairs', {
  headers: {
    'X-API-Key': apiKey
  }
});

Python

import os
import requests

api_key = os.environ.get('EZYS_API_KEY')

response = requests.get(
    'https://api.ezys.io/v1/pairs',
    headers={'X-API-Key': api_key}
)

---

인증 오류

API Key 없음

HTTP/1.1 401 Unauthorized

{
  "success": false,
  "error": {
    "code": "MISSING_API_KEY",
    "message": "API key is required"
  }
}

잘못된 API Key

HTTP/1.1 401 Unauthorized

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}

비활성화된 API Key

HTTP/1.1 403 Forbidden

{
  "success": false,
  "error": {
    "code": "API_KEY_DISABLED",
    "message": "This API key has been disabled"
  }
}

---

IP Whitelist (Optional)

보안 강화를 위해 IP Whitelist를 설정할 수 있습니다.

요청 시 EZYS 팀에 허용할 IP 목록을 전달하세요.

Allowed IPs:
- 203.0.113.10
- 203.0.113.11

---

Key Rotation

API Key 교체가 필요한 경우:

1. EZYS 팀에 새 Key 발급 요청

2. 새 Key로 교체 배포

3. 기존 Key 비활성화 요청

두 Key가 동시에 활성화된 기간 동안 안전하게 교체할 수 있습니다.

---

지원

인증 관련 문의: [email protected]