Дашборд отлично подходит для управления одним приложением. Но команды, которые используют 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
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"] }'
Это заменяет ручной труд для платформ, выделяющих отдельное приложение под каждого клиента, для команд, предоставляющих каждому партнеру или оператору ноды собственное приложение для изоляции статистики, или для пайплайнов, создающих новое приложение под каждое окружение. Ключи доступа имеют собственные области действия, сроки жизни и возможность ротации, поэтому подготовку приложений можно встроить в процессы CI/CD наравне со всем остальным, вместо того чтобы выполнять действия только через дашборд.
Usage API
Usage API — это конечная точка только для чтения, предоставляющая данные, которые иначе пришлось бы смотреть на вкладке Usage в дашборде: общее количество вычислений (CU) в целом и в разрезе сетей, показатели с начала месяца, а также (на платных тарифах) детализацию по приложениям, методам и сетям для HTTP, WebSocket и вебхуков, статистику использования в долларах и количество запросов.
bash
Copied
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, привязанного к конкретному приложению и отправляемого тем же способом, если вам нужны данные только по одному приложению.
Начало работы
Создайте ключ доступа на вкладке Security, выберите необходимые разрешения и отправляйте запросы на адрес https://admin-api.alchemy.com/v1.
Ознакомьтесь с документацией и обратитесь к нашей команде, если у вас возникнут вопросы или потребуется обсудить индивидуальные решения для масштабных проектов.
Часто задаваемые вопросы (FAQ)
В чем разница между Apps Management и Usage?
Apps Management создает приложения и управляет их настройками: именами, списками разрешенных сетей, а также списками разрешенных адресов, доменов и IP. Usage работает только на чтение. Он возвращает общие суммы единиц вычислений (CU), а на платных тарифах — временные ряды с детализацией. Ограничьте область действия ключа доступа только теми разрешениями, которые вам необходимы.
Как пройти аутентификацию в Admin API?
Создайте ключ доступа на вкладке 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 — полная детализация.
