---
title: "Admin API 소개"
description: "Apps Management와 Usage가 정식 출시되었습니다. 하나의 엔드포인트와 하나의 Access Key로 앱 생성, allowlist 관리, 대시보드 사용량 조회를 할 수 있습니다."
---

# Admin API 소개

<ImageBlock
  src="https://media.alchemy.com/admin-apis.png"
  alt="앱 관리 및 사용량을 위한 Alchemy Admin API 소개"
  width={3840}
  height={2160}
  priority
/>

대시보드는 앱 하나를 관리할 때는 잘 작동합니다. 하지만 고객별, 파트너별, 또는 환경별로 전용 앱을 두고 Alchemy를 대규모로 운영하는 팀은 반복 작업에 부딪히게 됩니다. 같은 생성 플로우, allowlist 업데이트, 사용량 확인을 계속 클릭해야 하는 것입니다.

그래서 빌더들이 이를 더 쉽고 매끄럽게 처리할 수 있도록 두 가지 [Admin API](https://www.alchemy.com/docs/reference/admin-api/overview)를 공개하게 되었습니다:

- **[Apps Management API](https://www.alchemy.com/docs/admin-api/apps/list-apps):** 앱 생성, 설정, 삭제, allowlist 관리.
- **[Usage API](https://www.alchemy.com/docs/admin-api/usage/get-usage-summary):** 대시보드의 Usage 탭과 동일한 사용량 수치를 가져옵니다.

두 API 모두 하나의 엔드포인트에서 하나의 Access Key로 접근할 수 있습니다. 대시보드의 Settings → Security에서 App Management 또는 Usage로 범위를 지정한 Access Key를 발급받아 `https://admin-api.alchemy.com/v1`에 사용하면 됩니다.

## Apps Management API

Apps Management API는 대시보드에서 수동으로 처리하던 CRUD 작업을 대신 처리합니다: 앱 생성, 네트워크 allowlist 설정, 주소, 도메인, IP allowlist 관리.

<CodeSnippet
  language="bash"
  code={`curl -X POST 'https://admin-api.alchemy.com/v1/apps' \\
  --header 'Content-Type: application/json' \\
  --header 'Authorization: Bearer {your access key}' \\
  --data '{
    "name": "app-tenant-42",
    "networkAllowlist": ["ETH_MAINNET"],
    "products": ["node-api"]
  }'`}
/>

고객별로 전용 앱을 프로비저닝하는 플랫폼, 각 파트너나 노드 운영자에게 사용량을 분리하기 위해 각자의 앱을 부여하는 팀, 또는 환경마다 새 앱을 생성하는 파이프라인의 수작업을 대체합니다. Access Key는 자체적인 범위, 만료, 회전 정책을 가지므로, 앱 프로비저닝이 대시보드에서만 가능한 작업이 아니라 CI/CD 안에 다른 작업들과 함께 위치할 수 있습니다.

## Usage API

Usage API는 대시보드의 Usage 탭에서 가져오던 수치를 위한 읽기 전용 엔드포인트입니다: 전체 및 네트워크별 총 [CU](https://www.alchemy.com/docs/reference/compute-units), 그리고 월간 누적 수치, 유료 플랜의 경우 앱별, 메서드별, 네트워크별 세부 내역(HTTP, WebSocket, webhook 트래픽 포함), 달러 단위 사용량, 요청 수까지 포함됩니다.

<CodeSnippet
  language="bash"
  code={`curl 'https://admin-api.alchemy.com/v1/usage/summary' \\
  --header 'Authorization: Bearer {your access key}'`}
/>

히스토리와 세부 정보 제공 범위는 이용 중인 플랜에 따라 달라집니다:

<EmbeddedTable
  table={{
    columns: [
      { key: "plan", width: 180, title: "Plan", dataType: "object" },
      {
        key: "access",
        width: 420,
        title: "What's included",
        dataType: "object",
      },
    ],
    data: [
      {
        plan: { title: "Free", tooltip: "", icon: "" },
        access: {
          title: "High-level CU summary, 1 day of history",
          tooltip: "",
          icon: "",
        },
        id: 0,
      },
      {
        plan: { title: "PAYG", tooltip: "", icon: "" },
        access: {
          title: "Full breakdown, 7 days of history",
          tooltip: "",
          icon: "",
        },
        id: 1,
      },
      {
        plan: { title: "Enterprise", tooltip: "", icon: "" },
        access: {
          title: "Full breakdown, 30 days of history",
          tooltip: "",
          icon: "",
        },
        id: 2,
      },
    ],
  }}
/>

두 가지 자격 증명 중 하나를 bearer 토큰으로 사용해 인증할 수 있습니다: 팀 전체 수치가 필요하면 읽기 전용 Usage 범위의 Access Key를, 하나의 앱에 대한 수치만 필요하면 기존의 앱 범위 API 키를 동일한 방식으로 전송하면 됩니다.

## 시작하기

Security 탭에서 Access Key를 생성하고, 필요한 범위로 지정한 뒤 `https://admin-api.alchemy.com/v1`을 호출하세요.

[문서](https://www.alchemy.com/docs/reference/admin-api/overview)를 살펴보시고, 대규모 특화 솔루션에 대한 논의나 문의사항이 있으시면 [저희 팀에 연락](https://www.alchemy.com/contact-sales)해 주세요.

## FAQ

### Apps Management와 Usage의 차이는 무엇인가요?

Apps Management는 앱을 생성하고 설정합니다: 이름, 네트워크 allowlist, 주소, 도메인, IP allowlist. Usage는 읽기 전용입니다. compute-unit 총합과, 유료 플랜에서는 시계열 세부 내역을 반환합니다. Access Key는 필요한 권한에만 범위를 지정하세요.

### Admin API에 어떻게 인증하나요?

대시보드의 Security 탭에서 Access Key를 생성하고 App Management 및/또는 Usage를 활성화한 뒤, `Authorization: Bearer {your access key}`로 `https://admin-api.alchemy.com/v1`에 전송하세요.

### 사용량 히스토리는 얼마나 제공되나요?

시계열 범위는 Free에서 1일, PAYG에서 7일, Enterprise에서 30일입니다. Free는 high-level CU 요약을 제공하며, PAYG와 Enterprise는 전체 세부 내역을 제공합니다.