Saltar al contenido
0%

Presentamos Admin APIs

Autor: Alchemy

Última actualización: 26 de agosto de 20263 min de lectura
Presentamos Alchemy Admin APIs para la gestión y el uso de apps

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 para que esto sea más fácil y más fluido para los builders:

  • Apps Management API: crea, configura y elimina apps, administra allowlists.
  • Usage API: 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.

bash
Copied
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 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.

bash
Copied
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:

Plan
What's included
Free
High-level CU summary, 1 day of history
PAYG
Full breakdown, 7 days of history
Enterprise
Full breakdown, 30 days of history

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, y contacta a nuestro equipo 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.

Boletín de Alchemy

Entérate primero de los lanzamientos

Suscríbete a nuestro boletín

Recibe las últimas actualizaciones de productos y recursos de Alchemy

A
O
D
+
Más de 80,000 suscriptores

Al ingresar tu correo electrónico, aceptas recibir nuestras comunicaciones de marketing y actualizaciones de productos. Reconoces que Alchemy procesa la información que recibimos de acuerdo con nuestro Aviso de Privacidad. Puedes cancelar tu suscripción en cualquier momento.