API 키
동결된 서피스 (대시보드 UI)
클라우드 대시보드의 전용 API Keys 페이지는 현재 명시적인 제품 결정(2026-07-14, 저장소의 docs/FROZEN_SURFACES.md 참고)에 의해 동결되었습니다: 사이드바 항목이 숨겨져 있고 /api-keys는 /dashboard로 리디렉션됩니다. 아래에 설명된 API 키 백엔드, 기존 키, REST API는 라이브 상태로 유지되지만 동결이 해제될 때까지 새로운 API 키 UI 기능 작업은 계획되어 있지 않습니다. REST API 또는 지원팀을 통해 API 키를 관리하세요.
클라우드 전용
API 키는 클라우드 버전에서만 사용할 수 있습니다.
API 키를 사용하면 외부 서비스, 스크립트, 또는 통합에서 ADHDev의 REST API에 접근할 수 있습니다.
API 키 생성
- 사이드바에서 API Keys로 이동합니다.
- Create API Key를 클릭합니다.
- 설명적인 이름을 입력합니다.
- 키를 복사합니다 — 다시 표시되지 않습니다!
API 키는 식별이 쉽도록 adk_ 접두사가 붙습니다.
API 키 사용
Authorization 헤더에 키를 포함하세요:
bash
curl -H "Authorization: Bearer adk_your_key_here" \
https://api.adhf.dev/api/v1/daemons사용 가능한 엔드포인트
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/daemons | 연결된 머신 목록 |
| GET | /api/v1/daemons/{daemonId}/status | 현재 머신 스냅샷 읽기 |
| POST | /api/v1/shortcuts/{daemonId}/launch | IDE, CLI, 또는 ACP 대상 실행 |
| POST | /api/v1/shortcuts/{ideId}/chat | 에이전트에 메시지 전송 |
| POST | /api/v1/shortcuts/{ideId}/approve | 작업 승인 또는 거부 |
| GET | /api/v1/shortcuts/{ideId}/chat | 현재 채팅 읽기 |
| GET/POST | /api/v1/shortcuts/{ideId}/chat/debug | 정제된 채팅 디버그 번들 빌드 |
| GET | /api/v1/shortcuts/{ideId}/status | 현재 에이전트 상태 읽기 |
전체 API 레퍼런스 →
플랜 제한
| 플랜 | API 키 수 | 월간 API 호출 |
|---|---|---|
| Free | 3 | 1,000 |
| Pro | 10 | 50,000 |
| Ultra | 30 | 500,000 |
| Enterprise | 무제한 | 무제한 |
현재 사용량은 Account → Account 탭 → Plan limits에서 확인할 수 있습니다.
보안
- 키는 저장 전에 해시 처리됩니다 — 키를 복구할 수 없습니다.
- API Keys 페이지에서 언제든지 키를 취소할 수 있습니다.
- 각 키는 특정 권한 범위로 한정할 수 있습니다.
- API 키는 자체 머신과 세션에 대한 클라우드 자동화용입니다. 민감한 설정 변경에 대한 계정 보안 검사를 우회하기 위한 것이 아닙니다.
- 키 생성 또는 취소는 클라우드 대시보드에서 최근 로그인이 보호하는 작업이므로, 오래된 브라우저 세션은 변경 전에 재인증이 필요할 수 있습니다.