API 키

클라우드 전용

API 키는 클라우드 버전에서만 사용할 수 있습니다.

API 키를 사용하면 외부 서비스, 스크립트, 또는 통합에서 ADHDev의 REST API에 접근할 수 있습니다.

API 키 생성

사이드바에서 API를 열고 키 이름을 입력한 뒤 스코프를 선택하고 키를 복사하세요 — 키는 한 번만 표시됩니다.

API 키는 식별이 쉽도록 adk_ 접두사가 붙습니다.

API 키 사용

Authorization 헤더에 키를 포함하세요:

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/{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 페이지(또는 REST API)에서 언제든지 키를 취소할 수 있습니다
• 각 키는 특정 권한 범위로 한정할 수 있습니다.
• API 키는 자체 머신과 세션에 대한 클라우드 자동화용입니다. 민감한 설정 변경에 대한 계정 보안 검사를 우회하기 위한 것이 아닙니다.
• 키 생성 또는 취소는 최근 로그인이 보호하는 작업이므로, 오래된 브라우저 세션은 변경 전에 재인증이 필요할 수 있습니다.