Представляем Admin API

Последнее обновление: 26 августа 2026 г.Время чтения: 3 мин

Дашборд отлично подходит для управления одним приложением. Но команды, использующие Alchemy в больших масштабах — например, выделяя отдельное приложение под каждого клиента, партнера или окружение, — сталкиваются с рутинными задачами. Им приходится выполнять одни и тем же действия: создавать приложения, обновлять списки разрешенных адресов и проверять статистику использования.

Именно поэтому мы рады представить два новых Admin API, которые сделают работу разработчиков проще и удобнее:

• Apps Management API: создание, настройка и удаление приложений, а также управление списками разрешенных адресов.

• Usage API: получение тех же данных об использовании, что и на вкладке Usage в дашборде.

Оба API доступны через единую точку входа с использованием одного ключа Access Key. Получите ключ доступа в разделе Settings → Security в дашборде, настройте для него необходимые права (App Management или Usage) и отправляйте запросы на адрес https://admin-api.alchemy.com/v1.

Apps Management API

Apps Management API берет на себя все операции CRUD, которые раньше приходилось выполнять вручную в дашборде: создание приложения, настройку списка разрешенных сетей, а также управление списками разрешенных адресов, доменов и IP-адресов.

bash

Скопировано

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

Это избавляет от ручной работы платформы, выделяющие отдельное приложение под каждого клиента; команды, предоставляющие каждому партнеру или оператору ноды собственное приложение для изоляции трафика; или пайплайны, которые развертывают свежее приложение под каждое окружение. Ключи доступа поддерживают собственные уровни доступа, сроки действия и ротацию, поэтому процесс создания приложений теперь можно встроить в CI/CD наравне со всем остальным, вместо того чтобы выполнять его вручную через дашборд.

Usage API

Usage API — это эндпоинт только для чтения, предоставляющий данные, которые раньше можно было найти на вкладке Usage в дашборде: общее количество CU (вычислительных единиц) суммарно и в разрезе сетей, данные за текущий месяц, а также (на платных тарифах) детальную разбивку по приложениям, методам и сетям для HTTP-, WebSocket- и вебхук-трафика, расходы в долларах и количество запросов.

bash

Скопировано

curl 'https://admin-api.alchemy.com/v1/usage/summary' \ --header 'Authorization: Bearer {your access key}'

Глубина истории и детализация зависят от вашего тарифного плана:

Тарифный план

Что входит

Free

Общая сводка CU, история за 1 день

PAYG

Полная детализация, история за 7 дней

Enterprise

Полная детализация, история за 30 дней

Для аутентификации используйте любой из ключей в качестве Bearer-токена: ключ доступа с правами только на чтение Usage для получения статистики по всей команде или существующий API-ключ приложения (передаваемый тем же способом), если вам нужны данные только по одному конкретному приложению.

Начало работы

Создайте ключ Access Key на вкладке Security, выберите необходимые права доступа и отправьте запрос на адрес https://admin-api.alchemy.com/v1.

Изучите документацию и обратитесь к нашей команде, если у вас возникнут вопросы или вы захотите обсудить индивидуальные решения для масштабных проектов.

Часто задаваемые вопросы

В чем разница между Apps Management и Usage?

Apps Management позволяет создавать приложения и управлять их настройками: названиями, списками разрешенных сетей, адресов, доменов и IP-адресов. Usage — это интерфейс только для чтения. Он возвращает общее количество вычислительных единиц (CU), а на платных тарифах — временны́е ряды с детализацией. Ограничивайте права доступа ключа Access Key только теми разрешениями, которые вам действительно необходимы.

Как выполнить аутентификацию в Admin API?

Создайте ключ Access Key на вкладке Security в дашборде, выберите нужные права (App Management и/или Usage) и передайте его в заголовке Authorization: Bearer {your access key} при запросе к https://admin-api.alchemy.com/v1.

За какой период доступна история использования?

Глубина временны́х рядов составляет 1 день на тарифе Free, 7 дней на PAYG и 30 дней на Enterprise. На тарифе Free доступна общая сводка CU, а на PAYG и Enterprise — полная детализация.