# 인증

> URL: https://foura.ai/ko/docs/getting-started/authentication
> Updated: 2026-10-29
> Index: https://foura.ai/llms.txt

FourA API에 대한 모든 request에는 인증이 필요합니다. 이 페이지에서는 API key를 발급받고 사용하며 관리하는 방법을 설명합니다.

## API Key 발급받기

1. [FourA 대시보드](https://foura.ai/dashboard)에 로그인합니다
2. **API Keys** 페이지로 이동합니다
3. **Create Key**를 클릭합니다
4. 확인 대화상자에서 key를 복사합니다

API key는 다음과 같은 형식입니다: `pk_live_a1b2c3d4e5f6...`

현재 생성되는 key는 다시 확인할 수 있습니다. 나중에 해당 key 행의 눈 아이콘을 클릭하여 전체 secret을 필요할 때 다시 표시할 수 있습니다(확인 절차 및 권한은 [API Key 관리](https://foura.ai/docs/dashboard/api-keys) 참조). 해당 기능 지원 전에 생성된 레거시 key는 다시 표시할 수 없으며 자물쇠 아이콘이 표시됩니다. 전환하려면 key를 한 번 재생성하십시오.

## API Key 사용하기

모든 request의 `X-API-Key` header에 API key를 포함해야 합니다:

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'
```

Python 사용 시:

```python
import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"method": "GET", "url": "https://example.com"}
)
```

Node.js 환경:

```javascript
const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ method: 'GET', url: 'https://example.com' })
});
```

## API Key 보안

API key는 비밀번호처럼 다루어야 합니다.

- **버전 관리 시스템에 커밋하지 마세요.** 대신 환경 변수를 사용하세요.
- **클라이언트 측 코드에 노출하지 마세요.** 서버 측 애플리케이션에서만 사용하세요.
- **유출된 경우 즉시 교체하세요.** Dashboard에서 키를 재생성할 수 있습니다. 기존 보안 키는 1분 이내에 작동을 멈추며, 키 조회 내역은 모두 감사 로그에 기록되므로 탈취된 자격 증명을 사후에 쉽게 파악할 수 있습니다.

### 환경 변수 사용

키를 환경 변수에 저장하세요.

```bash
export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."
```

그런 다음 코드에서 이를 참조합니다.

```python
import os
api_key = os.environ["FOURA_API_KEY"]
```

```javascript
const apiKey = process.env.FOURA_API_KEY;
```

## 일반적인 인증 오류

모든 인증 실패는 `401 Unauthorized` 상태를 반환합니다.

| 오류 | 메시지 | 원인 | 해결 방법 |
|-------|---------|-------|-----|
| 401 | Missing API key. Include X-API-Key header. | request에 `X-API-Key` header가 없음 | `X-API-Key` header 추가 |
| 401 | Invalid API key | 잘못된 키, 불필요한 공백, 또는 비활성화된 키 | 키를 확인하거나, 공백을 제거하거나, Dashboard에서 새 키를 생성 |

데이터베이스 전환 중 등으로 인해 FourA가 일시적으로 키를 확인할 수 없는 경우, `401`가 아닌 `API key check temporarily unavailable` 및 `Retry-After: 5`와 함께 `503`로 응답합니다. 해당 대기 시간 후 재시도하십시오. 키 자체에는 문제가 없습니다.

성공과 실패에 관계없이 모든 response에는 `X-Foura-Request-Id` header가 포함됩니다. 단, FourA가 전혀 읽을 수 없는 body(잘못된 형식의 JSON 또는 100KB 초과 body)는 ID가 할당되기 전에 거부되므로 예외입니다. 지원팀에서 나중에 특정 호출을 조회할 수 있도록 해당 ID를 직접 로깅하십시오.

## 다음 단계

- [빠른 시작](https://foura.ai/docs/getting-started/quick-start): 첫 request 보내기
- [API 키 관리](https://foura.ai/docs/dashboard/api-keys): 키 확인, 수정, 재생성 및 삭제
- [API 엔드포인트](https://foura.ai/docs/api/endpoints): 전체 endpoint 레퍼런스
- [오류 처리](https://foura.ai/docs/api/errors): 인증 오류를 안정적으로 처리하기
