---
title: "Presentamos Admin APIs"
description: "Apps Management y Usage ya están disponibles de forma general. Crea apps, administra allowlists y obtén el uso del dashboard desde un solo endpoint con una sola Access Key."
---

# Presentamos Admin APIs

<ImageBlock
  src="https://media.alchemy.com/admin-apis.png"
  alt="Presentamos Alchemy Admin APIs para la gestión y el uso de apps"
  width={3840}
  height={2160}
  priority
/>

El dashboard funciona bien para administrar una sola app. Pero los equipos que corren Alchemy a escala, una app dedicada por cliente, por partner o por entorno, terminan con tareas repetitivas. Están haciendo clic una y otra vez en el mismo flujo de creación, la misma actualización de allowlist y la misma revisión de uso.

Por eso nos entusiasma abrir dos [Admin APIs](https://www.alchemy.com/docs/reference/admin-api/overview) para que esto sea más fácil y más fluido para los builders:

- **[Apps Management API](https://www.alchemy.com/docs/admin-api/apps/list-apps):** crea, configura y elimina apps, administra allowlists.
- **[Usage API](https://www.alchemy.com/docs/admin-api/usage/get-usage-summary):** obtén los mismos números de uso que la pestaña Usage del dashboard.

Ambas APIs son accesibles desde un solo endpoint con una sola Access Key. Consigue una Access Key en Settings → Security en el dashboard, con el alcance (scope) de App Management o Usage, y apúntala a `https://admin-api.alchemy.com/v1`.

## Apps Management API

La Apps Management API maneja el CRUD que de otra forma harías a mano en el dashboard: crear una app, configurar su allowlist de networks y administrar sus allowlists de direcciones, dominios e IPs.

<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"]
  }'`}
/>

Esto reemplaza el trabajo manual para una plataforma que aprovisiona una app dedicada por cliente, un equipo que le da a cada partner u operador de nodo su propia app para aislar el uso, o un pipeline que levanta una app nueva por entorno. Las Access Keys tienen sus propios scopes, expiración y rotación, así que el aprovisionamiento de apps puede vivir en CI/CD junto con todo lo demás en lugar de ser un paso exclusivo del dashboard.

## Usage API

La Usage API es un endpoint de solo lectura para los números que de otra forma obtendrías en la pestaña Usage del dashboard: [CUs](https://www.alchemy.com/docs/reference/compute-units) totales, en general y por network, y del mes en curso, además, en planes pagos, desgloses por app, método y network a través de tráfico HTTP, WebSocket y webhook, uso denominado en dólares y conteos de requests.

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

El historial y el nivel de detalle escalan según el plan en el que estés:

<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,
      },
    ],
  }}
/>

Autentícate con cualquiera de las dos credenciales como bearer token: una Access Key con scope de solo lectura para Usage, para obtener números a nivel de todo el equipo, o una API key existente con scope de app, enviada de la misma forma, si solo necesitas los números de una app.

## Comienza ahora

Crea una Access Key desde la pestaña Security, dale el scope que necesites y llama a `https://admin-api.alchemy.com/v1`.

Explora la [documentación](https://www.alchemy.com/docs/reference/admin-api/overview), y [contacta a nuestro equipo](https://www.alchemy.com/contact-sales) si tienes preguntas o quieres hablar sobre soluciones especializadas a escala.

## Preguntas frecuentes

### ¿Cuál es la diferencia entre Apps Management y Usage?

Apps Management crea y configura apps: nombres, allowlists de networks y allowlists de direcciones, dominios e IPs. Usage es de solo lectura. Devuelve totales de compute units y, en planes pagos, desgloses de series de tiempo. Dale a la Access Key únicamente el permiso que necesites.

### ¿Cómo me autentico en la Admin API?

Crea una Access Key en la pestaña Security del dashboard, habilita App Management y/o Usage, y envíala como `Authorization: Bearer {your access key}` a `https://admin-api.alchemy.com/v1`.

### ¿Cuánto historial de uso obtengo?

El rango de la serie de tiempo es de 1 día en Free, 7 días en PAYG y 30 días en Enterprise. Free ofrece un resumen general de CU; PAYG y Enterprise obtienen el desglose completo.