메인 콘텐츠로 건너뛰기
미리 보기 — CloudThinker REST API는 얼리 액세스 단계입니다. 엔드포인트, 페이로드, 인증 플로우는 정식 출시 전에 변경될 수 있습니다. 미리 보기 참여를 원하시면 문의하기를 클릭하세요.
CloudThinker API는 웹 콘솔에서 제공하는 동일한 작업을 인증된 HTTPS 엔드포인트로 노출합니다. 자체 제품에 클라우드 운영을 임베드하거나, 워크플로를 자동화하거나, CloudThinker를 내부 도구와 연동하는 데 활용하세요.

사용 가능한 기능

기능설명
대화 시작@agent #tool 프롬프트로 에이전트 대화를 프로그래밍 방식으로 시작하고 응답을 앱으로 스트리밍
리소스 조회AWS, GCP, Azure에 걸친 클라우드 리소스, 비용, 토폴로지의 통합 인벤토리 조회
권장 사항 관리비용, 보안, 안정성 권장 사항 목록 조회, 수락, 무시 또는 댓글 추가
인시던트 처리인시던트 생성, 신호 첨부, RCA 요청, 조사 결과 조회

인증

API는 베어러 토큰 헤더를 통해 전달되는 워크스페이스 범위의 API 키를 사용합니다.
curl https://api.cloudthinker.io/v1/workspaces/{workspace_id}/resources \
  -H "Authorization: Bearer $CLOUDTHINKER_API_KEY"
필드설명
범위각 키는 단일 워크스페이스에 바인딩됩니다
권한키를 발급한 멤버의 역할을 상속합니다
교체워크스페이스 설정에서 언제든지 키를 폐기할 수 있습니다

엔드포인트

리소스용도
/v1/workspaces워크스페이스 메타데이터 및 멤버
/v1/conversations에이전트 대화 시작, 목록 조회, 재개
/v1/resources발견된 클라우드 리소스 인벤토리
/v1/recommendations비용, 보안, 안정성 권장 사항
/v1/incidents인시던트 생명주기 및 RCA 결과
/v1/dashboards기본 제공 및 사용자 정의 대시보드 데이터
/v1/skills워크스페이스 Skills 및 실행
/v1/connections클라우드 및 SaaS 연동

버전 관리

API는 URL 경로(/v1/)에 버전이 명시됩니다. 호환성이 깨지는 변경 사항은 새 버전으로 출시되며, 추가적인 변경 사항은 현재 버전에서 제공됩니다. 더 이상 사용되지 않는 버전은 후속 버전 출시 후 최소 12개월간 계속 사용할 수 있습니다.

관련 항목

MCP Server

MCP 호환 AI 클라이언트에서 CloudThinker 도구 사용

CLI

터미널에서 CloudThinker 작업 실행

Webhooks

폴링 대신 이벤트 기반 알림 수신

연동

클라우드 공급자 및 SaaS 시스템 연결