API 연결 (REST API) — Content Launcher (콘텐츠 런처)
API 연결 (REST API) API 연결(REST API) 은 Content Launcher를 표준 REST API 로 노출해, bmp.ai 등 외부 시스템이 일반 HTTP 클라이언트로 36개 도구를 호출하게 해 줍니다. (MCP 연결과 같은 기능을 REST로 제공) 계정 단위 키
핵심 요약
- Content Launcher를 표준 REST API로 노출해 외부 시스템이 HTTP 클라이언트로 36개 도구를 호출할 수 있게 합니다.
- API 키는 계정 단위로 발급되며 발급 시 워크스페이스를 선택하지 않고 본인이 속한 모든 워크스페이스를 다룹니다.
- 호출 권한은 키의 scope(read/write)와 해당 워크스페이스에서의 본인 역할(owner/admin/editor/viewer)이 모두 충족되어야 합니다.
- 엔드포인트는 카탈로그 조회, 워크스페이스 목록 조회, 도구 호출(workspace_id 필수)로 구성됩니다.
- 키는 발급 직후 한 번만 표시되며 서버에는 해시만 저장되므로 분실 시 폐기 후 재발급해야 합니다.
# API 연결 (REST API)
API 연결(REST API) 은 Content Launcher를 표준 REST API로 노출해, bmp.ai 등 외부 시스템이 일반 HTTP 클라이언트로 36개 도구를 호출하게 해 줍니다. (MCP 연결과 같은 기능을 REST로 제공)
- 계정 단위 키: 키는 본인 계정에 귀속되며, 본인이 멤버인 모든 워크스페이스를 다룹니다. 발급 시 워크스페이스를 고르지 않습니다.
- 권한 2-팩터: 키 scope(read/write) + 그 워크스페이스에서 본인 역할(owner/admin/editor/viewer)이 둘 다 충족해야 호출됩니다.
- 엔드포인트:
GET /(카탈로그·인증 불필요) ·GET /workspaces·POST /tools/{도구명}(body에workspace_id필수). - 키는 발급 직후 한 번만 표시됩니다(서버엔 해시만 저장). 분실 시 폐기 후 재발급하세요.
사용 흐름: 키 발급 → 클라이언트 등록 → list_workspaces로 워크스페이스 확인 → 해당 workspace_id로 도구 호출. 호출 예시(curl·JS)는 화면 하단에 있습니다.
자주 묻는 질문
API 키를 발급할 때 워크스페이스를 선택해야 하나요?
아니요, 키는 계정 단위로 발급되며 발급 시 워크스페이스를 고르지 않습니다. 발급된 키는 본인이 멤버로 속한 모든 워크스페이스를 다룰 수 있습니다.
키만 있으면 아무 워크스페이스에서나 도구를 호출할 수 있나요?
아닙니다. 키의 scope(read/write)와 해당 워크스페이스에서 본인의 역할(owner/admin/editor/viewer)이 둘 다 충족되어야 호출이 가능합니다.
발급받은 키를 잊어버리면 다시 확인할 수 있나요?
키는 발급 직후 한 번만 표시되고 서버에는 해시만 저장되므로 이후에는 확인할 수 없습니다. 분실했다면 기존 키를 폐기하고 재발급받아야 합니다.
실제로 도구를 호출하려면 어떤 순서로 진행하나요?
먼저 키를 발급받고 클라이언트에 등록한 뒤, list_workspaces로 워크스페이스를 확인하고 해당 workspace_id로 도구를 호출하면 됩니다.
도구 호출 엔드포인트는 어떻게 구성되어 있나요?
GET /는 카탈로그 조회용으로 인증이 필요 없고, GET /workspaces는 워크스페이스 목록을 반환하며, POST /tools/{도구명}은 body에 workspace_id를 필수로 포함해 호출합니다.