# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://openapi-docs.exosp.com/start/api-key.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.