Дашборд отлично подходит для управления одним приложением. Но команды, использующие 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 — полная детализация.
