> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ko/docs/api.md).

# API 참조

애플리케이션, 버전, 배포, 릴레이를 프로그래밍 방식으로 관리하기 위한 Edgegap HTTP API 참조입니다.

HTTP 요청을 사용하여 Edgegap 리소스의 관리 기능에 액세스하세요.

<a href="https://raw.githubusercontent.com/edgegap/openapi-specification/refs/heads/main/edgegap-v2-openapi.yaml" class="button primary" data-icon="square-down">openapi \[v2] 다운로드</a> <a href="http://raw.githubusercontent.com/edgegap/openapi-specification/refs/heads/main/edgegap-v1-openapi.yaml" class="button secondary" data-icon="square-down">openapi \[v1] 다운로드</a>&#x20;

{% hint style="info" %}
도움이 필요하시면 [디스코드를 통해 문의해 주세요](https://discord.gg/MmJf8fWjnt). 실시간 게임 지원은 저희의 [티켓 시스템](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

### 인증 토큰

Edgegap API용 비밀 토큰 생성 위치: [대시보드 - 사용자 설정 / 토큰](https://app.edgegap.com/user-settings?tab=tokens).

각 API 요청의 HTTP 헤더에 비밀 토큰을 추가하세요(다음 단어를 포함해야 함:  `token`):

`Authorization: token xxxxxxxx-e458-4592-b607-c2c28afd8b62`

{% hint style="danger" %}
**API 토큰을 사용하면 계정에 제한 없이 접근할 수 있으므로 게임 클라이언트에 Edgegap API 엔드포인트를 통합하지 마세요. 안전한 클라이언트용 API 엔드포인트와 함수는**  [통합](https://docs.edgegap.com/ko/docs/api/integration.md) **을 참조하세요.**
{% endhint %}

{% hint style="success" %}
비밀 토큰이 유출되거나 노출된 경우 대시보드에서 삭제한 후 새로 만드세요.
{% endhint %}

### 응답 페이지네이션

응답에 항목이 너무 많을 경우, 페이지네이션 정보와 함께 데이터의 일부를 반환합니다:

<pre class="language-json"><code class="lang-json">{
  "total_count": 100,
  "data": ["foo-0", "[...]", "bar-9"],
  "<a data-footnote-ref href="#user-content-fn-1">pagination</a>": {
    "number": 1,
    "next_page_number": 2,
    "previous_page_number": null
    "paginator": {
      "num_pages": 10
    },
    "has_next": true,
    "has_previous": false
  }
}
</code></pre>

페이지네이션된 응답의 경우, 다음 매개변수를 사용하세요 `page` 및 `limit`  더 많은 결과를 가져오세요:

* 두 번째 페이지: `https://api.edgegap.com/v1/apps?`**`page=2`**
* 더 많은 결과: `https://api.edgegap.com/v1/apps?`**`limit=20`**
* 조합: `https://api.edgegap.com/v1/apps?`**`page=2&limit=20`**

### 요청 제한

플랫폼의 안정성을 보장하고 예상치 못한 청구서를 방지하기 위해, 귀사 조직의 API 사용량에 속도 제한을 적용합니다:

* [배포](https://docs.edgegap.com/ko/learn/orchestration/deployments.md) 초당 40개 요청으로,
* [배포](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#context-and-status) 초당 20개 요청으로.

{% hint style="info" %}
[문의하세요](mailto:info@edgegap.com) 위해 **출시를 계획하고, 부하 테스트를 실행하고, 출시 트래픽을 예측하고, 성공을 준비하세요.**
{% endhint %}

[^1]: 페이지네이션 정보를 포함합니다
