# 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)는 화면 하단에 있습니다.


## FAQ
**Q. API 키를 발급할 때 워크스페이스를 선택해야 하나요?**

A. 아니요, 키는 계정 단위로 발급되며 발급 시 워크스페이스를 고르지 않습니다. 발급된 키는 본인이 멤버로 속한 모든 워크스페이스를 다룰 수 있습니다.

**Q. 키만 있으면 아무 워크스페이스에서나 도구를 호출할 수 있나요?**

A. 아닙니다. 키의 scope(read/write)와 해당 워크스페이스에서 본인의 역할(owner/admin/editor/viewer)이 둘 다 충족되어야 호출이 가능합니다.

**Q. 발급받은 키를 잊어버리면 다시 확인할 수 있나요?**

A. 키는 발급 직후 한 번만 표시되고 서버에는 해시만 저장되므로 이후에는 확인할 수 없습니다. 분실했다면 기존 키를 폐기하고 재발급받아야 합니다.

**Q. 실제로 도구를 호출하려면 어떤 순서로 진행하나요?**

A. 먼저 키를 발급받고 클라이언트에 등록한 뒤, list_workspaces로 워크스페이스를 확인하고 해당 workspace_id로 도구를 호출하면 됩니다.

**Q. 도구 호출 엔드포인트는 어떻게 구성되어 있나요?**

A. GET /는 카탈로그 조회용으로 인증이 필요 없고, GET /workspaces는 워크스페이스 목록을 반환하며, POST /tools/{도구명}은 body에 workspace_id를 필수로 포함해 호출합니다.

---
출처: https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-api-연결-rest-api · 최종 갱신 2026-08-28T09:47:19.584+00:00