# API 키

## API키 발급 방법

1. 엑소스피어 [관리자 페이지](https://admin.exosp.com)에 로그인 합니다.
2. 서비스 관리 > 개발자 도구 > OpenAPI 로 이동합니다. 
3. API 키 관리 섹션에서 \[API 키 발급] 버튼을 클릭합니다.
4. 생성된 API 키를 안전한 장소에 보관합니다. 

{% hint style="warning" %}
Secret Key는 발급 시 단 한 번만 온전한 값이 표시됩니다. 분실한 경우 기존 키를 삭제하고 새 키를 발급 받으세요.
{% endhint %}

{% hint style="info" %}
API 키는 최대 2개까지 생성 가능합니다.
{% endhint %}

## API 요청 시 API 키 포함 방법

API 키를 발급받은 후, 이를 API 요청 헤더에 포함시켜야 합니다. 

### 요청 헤더

<table><thead><tr><th width="263">헤더 명</th><th>필드 값</th></tr></thead><tbody><tr><td>x-exosp-access</td><td>발급 받은 Access Key</td></tr><tr><td>x-exosp-secret</td><td>발급 받은 Secret Key</td></tr></tbody></table>

### API 키 에러

<table><thead><tr><th width="317">에러 메세지</th><th>해결 방법</th></tr></thead><tbody><tr><td>Invalid API Key: x-exosp-access.</td><td>x-exosp-access 값을 다시 확인해주세요.</td></tr><tr><td>Not Found API Key: x-exosp-access.</td><td>발급된 Access Key 인지 확인해주세요.</td></tr><tr><td>Invalid API Key: x-exosp-secret.</td><td>x-exosp-secret 값을 다시 확인해주세요.</td></tr><tr><td>Not Found API Key: x-exosp-secret.</td><td>Access Key와 매칭된 Secret Key를 사용하고 있는지 확인해주세요.</td></tr></tbody></table>