> ## Documentation Index
> Fetch the complete documentation index at: https://developer.alltalk.co.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 인증

> AllTalk API 호출 시 apikey 헤더 인증 방법

AllTalk API는 요청 헤더의 `apikey` 값으로 인증합니다.

<Note>
  `apikey`, `service`, `groupId` 는 [관리자](https://admin.alltalk.co.kr) 로그인 후
  **내정보 → API / 채널 정보** 탭에서 확인할 수 있습니다.
  자세한 방법은 [API 키 발급](/guides/getting-credentials) 페이지를 참고하세요.
</Note>

## 헤더 형식

```http theme={null}
apikey: {API_KEY}
Content-Type: application/json
```

## 예제

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.alltalk.co.kr/alimTalk \
    -H "apikey: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d @payload.json
  ```

  ```javascript Node.js theme={null}
  import axios from 'axios';

  await axios.post('https://api.alltalk.co.kr/alimTalk', talkData, {
    headers: { apikey: process.env.ALLTALK_API_KEY },
  });
  ```

  ```python Python theme={null}
  import os
  import requests

  requests.post(
      'https://api.alltalk.co.kr/alimTalk',
      json=talk_data,
      headers={'apikey': os.environ['ALLTALK_API_KEY']},
  )
  ```
</CodeGroup>

## 보안 주의사항

<Warning>
  * `apikey`는 서버 사이드에서만 사용하세요. 프론트엔드나 공개 저장소에 노출되면 안 됩니다.
  * 환경변수 또는 Secret Manager를 통해 관리하세요.
  * 유출이 의심되면 즉시 [관리자](https://admin.alltalk.co.kr) **내정보 → API / 채널 정보** 에서 재발급하세요.
</Warning>

## 인증 실패 시

| 에러 코드     | 설명                     |
| --------- | ---------------------- |
| `ERR_100` | `authToken` 데이터 누락     |
| `ERR_102` | header 데이터 미일치 (인증 실패) |

자세한 에러 코드는 [에러 코드](/guides/error-codes) 페이지를 참고하세요.