# 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="https://api.edgegap.com/swagger.json" class="button secondary" data-icon="square-down">openapi \[v1] 다운로드</a>&#x20;

### 인증 토큰

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 엔드포인트를 통합하지 마십시오. 자세한 내용은** [Broken link](https://docs.edgegap.com/docs.edgegap.com-ko/docs/broken-reference "mention") **클라이언트 측 보안 API 엔드포인트 및 기능을 참조하세요.**
{% endhint %}

{% hint style="success" %}
비밀 토큰이 유출된 경우 해당 토큰을 삭제하고 조직 구성원의 비밀번호를 업데이트하세요.
{% endhint %}

### 응답 페이지네이션

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

<pre class="language-json"><code class="lang-json">{
  "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`**

### 요청 제한(Rate Limiting)

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

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

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

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