Admin API 소개
작성자: Alchemy
대시보드는 앱 하나를 관리할 때는 잘 작동합니다. 하지만 고객별, 파트너별, 또는 환경별로 전용 앱을 두고 Alchemy를 대규모로 운영하는 팀은 반복 작업에 부딪히게 됩니다. 같은 생성 플로우, allowlist 업데이트, 사용량 확인을 계속 클릭해야 하는 것입니다.
그래서 빌더들이 이를 더 쉽고 매끄럽게 처리할 수 있도록 두 가지 Admin API를 공개하게 되었습니다:
- Apps Management API: 앱 생성, 설정, 삭제, allowlist 관리.
- Usage API: 대시보드의 Usage 탭과 동일한 사용량 수치를 가져옵니다.
두 API 모두 하나의 엔드포인트에서 하나의 Access Key로 접근할 수 있습니다. 대시보드의 Settings → Security에서 App Management 또는 Usage로 범위를 지정한 Access Key를 발급받아 https://admin-api.alchemy.com/v1에 사용하면 됩니다.
Apps Management API
Apps Management API는 대시보드에서 수동으로 처리하던 CRUD 작업을 대신 처리합니다: 앱 생성, 네트워크 allowlist 설정, 주소, 도메인, IP allowlist 관리.
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"]
}'고객별로 전용 앱을 프로비저닝하는 플랫폼, 각 파트너나 노드 운영자에게 사용량을 분리하기 위해 각자의 앱을 부여하는 팀, 또는 환경마다 새 앱을 생성하는 파이프라인의 수작업을 대체합니다. Access Key는 자체적인 범위, 만료, 회전 정책을 가지므로, 앱 프로비저닝이 대시보드에서만 가능한 작업이 아니라 CI/CD 안에 다른 작업들과 함께 위치할 수 있습니다.
Usage API
Usage API는 대시보드의 Usage 탭에서 가져오던 수치를 위한 읽기 전용 엔드포인트입니다: 전체 및 네트워크별 총 CU, 그리고 월간 누적 수치, 유료 플랜의 경우 앱별, 메서드별, 네트워크별 세부 내역(HTTP, WebSocket, webhook 트래픽 포함), 달러 단위 사용량, 요청 수까지 포함됩니다.
curl 'https://admin-api.alchemy.com/v1/usage/summary' \
--header 'Authorization: Bearer {your access key}'히스토리와 세부 정보 제공 범위는 이용 중인 플랜에 따라 달라집니다:
두 가지 자격 증명 중 하나를 bearer 토큰으로 사용해 인증할 수 있습니다: 팀 전체 수치가 필요하면 읽기 전용 Usage 범위의 Access Key를, 하나의 앱에 대한 수치만 필요하면 기존의 앱 범위 API 키를 동일한 방식으로 전송하면 됩니다.
시작하기
Security 탭에서 Access Key를 생성하고, 필요한 범위로 지정한 뒤 https://admin-api.alchemy.com/v1을 호출하세요.
문서를 살펴보시고, 대규모 특화 솔루션에 대한 논의나 문의사항이 있으시면 저희 팀에 연락해 주세요.
FAQ
Apps Management와 Usage의 차이는 무엇인가요?
Apps Management는 앱을 생성하고 설정합니다: 이름, 네트워크 allowlist, 주소, 도메인, IP allowlist. Usage는 읽기 전용입니다. compute-unit 총합과, 유료 플랜에서는 시계열 세부 내역을 반환합니다. Access Key는 필요한 권한에만 범위를 지정하세요.
Admin API에 어떻게 인증하나요?
대시보드의 Security 탭에서 Access Key를 생성하고 App Management 및/또는 Usage를 활성화한 뒤, Authorization: Bearer {your access key}로 https://admin-api.alchemy.com/v1에 전송하세요.
사용량 히스토리는 얼마나 제공되나요?
시계열 범위는 Free에서 1일, PAYG에서 7일, Enterprise에서 30일입니다. Free는 high-level CU 요약을 제공하며, PAYG와 Enterprise는 전체 세부 내역을 제공합니다.
Alchemy 뉴스레터
출시 소식을 가장 먼저 받아보세요
뉴스레터 구독하기
Alchemy의 최신 제품 업데이트와 리소스 받기
이메일 주소를 입력하면 마케팅 커뮤니케이션 및 제품 업데이트 수신에 동의하게 됩니다. Alchemy는 저희 개인정보 처리방침에 따라 수집한 정보를 처리합니다. 언제든지 구독을 취소할 수 있습니다.
관련 아티클
Glamsterdam: Ethereum 개발자를 위한 완전 가이드
Glamsterdam이 Sepolia에서 가동 중입니다. 개발자에게 무엇을 의미하는지, 그리고 Alchemy가 네트워크 업그레이드에 어떻게 준비했는지를 담은 완전 가이드입니다.
트레이딩 팀이 저지연 RPC로 Alchemy를 선택하는 이유
트레이딩 팀이 Alchemy를 선택하는 이유는, 시장이 움직일 때의 저지연 읽기와 쓰기, 그리고 거래량이 정점에 달해도 자금이 정산될 때의 신뢰할 수 있는 기록 때문이다.
도쿄에서 구축한다면 어떤 RPC 제공업체를 선택해야 할까
도쿄를 서비스하는 RPC 제공업체 다섯 곳을 다섯 개 체인에서 벤치마크했습니다. 비교 결과와, 지연 시간에 민감한 팀에게 차이가 어디서 나는지 정리합니다.