> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lexq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 인증

> API 키를 사용하여 API 요청을 인증합니다.

## API Key 인증

LexQ는 모든 API 요청을 인증하기 위해 API 키를 사용합니다. `x-api-key` 헤더에 키를 포함하세요:

```bash theme={null}
curl -X POST https://api.lexq.io/api/v1/execution/groups/{groupId} \
  -H "x-api-key: lexq_us_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"facts": {"payment_amount": 100000}}'
```

## API 키 발급

1. [LexQ 콘솔](https://console.lexq.io)에 로그인
2. **관리 → API 키**로 이동
3. **API 키 생성** 클릭
4. 키를 즉시 복사 — 다시 표시되지 않습니다

API 키는 `lexq_us_` 접두사 뒤에 Base64 문자열 형식입니다 (예: `lexq_us_a1b2c3d4e5f6...`).

## 키 관리

| 작업              | 설명                      |
| --------------- | ----------------------- |
| **생성**          | 선택적 설명과 함께 새 키를 생성      |
| **폐기 (Revoke)** | 키를 영구적으로 비활성화 (즉시 적용)   |
| **재발급**         | 기존 키를 폐기하고 새 키를 한 번에 발급 |

폐기된 키는 재활성화할 수 없습니다. 키가 유출된 경우 즉시 폐기하고 새 키를 생성하세요.

## 보안 모범 사례

* API 키를 클라이언트 코드, 공개 저장소, 브라우저 요청에 노출하지 마세요
* 환경 변수나 시크릿 매니저를 사용하여 키를 저장하세요
* 주기적으로 키를 교체하세요
* 개발/프로덕션 환경에 별도 키를 사용하세요
* 각 키는 단일 테넌트에 한정되며 교차 테넌트 접근은 불가합니다

## 범위

하나의 API 키로 동일 테넌트의 **관리 API** (`/api/v1/partners`)와 **실행 API** (`/api/v1/execution`) 모두 접근할 수 있습니다.

## 속도 제한

| 플랜     | 최대 TPS |
| ------ | ------ |
| Free   | 5      |
| Growth | 50     |
| Pro    | 200    |

한도 초과 시 HTTP `429 Too Many Requests`를 반환합니다.