{
  "id": "b998f1b4-3ba3-43f5-99af-5461b4c06655",
  "slug": "ref/manual/content-launcher-콘텐츠-런처-api-연결-rest-api",
  "doc_type": "ref",
  "title": "API 연결 (REST API) — Content Launcher (콘텐츠 런처)",
  "title_en": null,
  "one_liner": " API 연결 (REST API) API 연결(REST API) 은 Content Launcher를 표준 REST API 로 노출해, bmp.ai 등 외부 시스템이 일반 HTTP 클라이언트로 36개 도구를 호출하게 해 줍니다. (MCP 연결과 같은 기능을 REST로 제공) 계정 단위 키",
  "summary_bullets": [
    "Content Launcher를 표준 REST API로 노출해 외부 시스템이 HTTP 클라이언트로 36개 도구를 호출할 수 있게 합니다.",
    "API 키는 계정 단위로 발급되며 발급 시 워크스페이스를 선택하지 않고 본인이 속한 모든 워크스페이스를 다룹니다.",
    "호출 권한은 키의 scope(read/write)와 해당 워크스페이스에서의 본인 역할(owner/admin/editor/viewer)이 모두 충족되어야 합니다.",
    "엔드포인트는 카탈로그 조회, 워크스페이스 목록 조회, 도구 호출(workspace_id 필수)로 구성됩니다.",
    "키는 발급 직후 한 번만 표시되며 서버에는 해시만 저장되므로 분실 시 폐기 후 재발급해야 합니다."
  ],
  "body_md": "# API 연결 (REST API)\n\n**API 연결(REST API)** 은 Content Launcher를 표준 **REST API**로 노출해, bmp.ai 등 외부 시스템이 일반 HTTP 클라이언트로 36개 도구를 호출하게 해 줍니다. (MCP 연결과 같은 기능을 REST로 제공)\n\n* **계정 단위 키**: 키는 본인 계정에 귀속되며, 본인이 멤버인 **모든 워크스페이스**를 다룹니다. 발급 시 워크스페이스를 고르지 않습니다.\n* **권한 2-팩터**: 키 scope(read/write) + 그 워크스페이스에서 본인 역할(owner/admin/editor/viewer)이 **둘 다** 충족해야 호출됩니다.\n* **엔드포인트**: `GET /`(카탈로그·인증 불필요) · `GET /workspaces` · `POST /tools/{도구명}`(body에 `workspace_id` 필수).\n* 키는 발급 직후 **한 번만** 표시됩니다(서버엔 해시만 저장). 분실 시 폐기 후 재발급하세요.\n\n사용 흐름: 키 발급 → 클라이언트 등록 → `list_workspaces`로 워크스페이스 확인 → 해당 `workspace_id`로 도구 호출. 호출 예시(curl·JS)는 화면 하단에 있습니다.\n",
  "related_slugs": [],
  "faq": [
    {
      "a": "아니요, 키는 계정 단위로 발급되며 발급 시 워크스페이스를 고르지 않습니다. 발급된 키는 본인이 멤버로 속한 모든 워크스페이스를 다룰 수 있습니다.",
      "q": "API 키를 발급할 때 워크스페이스를 선택해야 하나요?"
    },
    {
      "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를 필수로 포함해 호출합니다.",
      "q": "도구 호출 엔드포인트는 어떻게 구성되어 있나요?"
    }
  ],
  "jsonld": null,
  "keywords": [],
  "source_id": "gitbook:UzjWwGASsQFDcNaCAGUu:LtHuXVjBdRHkWcltWTWr",
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "image_url": null,
  "caption": null,
  "solution_slug": null,
  "captured_at": null,
  "width": null,
  "height": null,
  "created_at": "2026-08-23T14:32:39.611542+00:00",
  "updated_at": "2026-08-28T09:47:19.584+00:00",
  "visibility": "public",
  "source_stage": "1",
  "anonymized": true,
  "source_key": "gitbook-manuals",
  "origin": "ingest",
  "locked": false,
  "locked_by": null,
  "locked_at": null,
  "gate_state": {
    "g1": {
      "hits": [],
      "pass": true
    },
    "g2": {
      "pass": false,
      "total": 22,
      "issues": [
        "본문이 짧습니다 (800자 미만)",
        "숫자·규격 같은 검증 가능한 구체가 부족합니다",
        "다른 문서와 겹치는 말이 대부분입니다",
        "핵심 요약 불릿이 3개 미만입니다",
        "Q&A 쌍이 3개 미만입니다",
        "소제목이 3개 미만이라 발췌 단위가 없습니다"
      ],
      "applies": true
    },
    "g3": {
      "pass": true,
      "required": false
    },
    "stage": "1",
    "decided_at": "2026-08-23T14:32:37.773Z"
  },
  "raw_id": "112a102d-dd9a-49bf-a99c-db1907741905",
  "search_text": "API 연결 (REST API) — Content Launcher (콘텐츠 런처)   API 연결 (REST API) API 연결(REST API) 은 Content Launcher를 표준 REST API 로 노출해, bmp.ai 등 외부 시스템이 일반 HTTP 클라이언트로 36개 도구를 호출하게 해 줍니다. (MCP 연결과 같은 기능을 REST로 제공) 계정 단위 키  # API 연결 (REST API)\n\n**API 연결(REST API)** 은 Content Launcher를 표준 **REST API**로 노출해, bmp.ai 등 외부 시스템이 일반 HTTP 클라이언트로 36개 도구를 호출하게 해 줍니다. (MCP 연결과 같은 기능을 REST로 제공)\n\n* **계정 단위 키**: 키는 본인 계정에 귀속되며, 본인이 멤버인 **모든 워크스페이스**를 다룹니다. 발급 시 워크스페이스를 고르지 않습니다.\n* **권한 2-팩터**: 키 scope(read/write) + 그 워크스페이스에서 본인 역할(owner/admin/editor/viewer)이 **둘 다** 충족해야 호출됩니다.\n* **엔드포인트**: `GET /`(카탈로그·인증 불필요) · `GET /workspaces` · `POST /tools/{도구명}`(body에 `workspace_id` 필수).\n* 키는 발급 직후 **한 번만** 표시됩니다(서버엔 해시만 저장). 분실 시 폐기 후 재발급하세요.\n\n사용 흐름: 키 발급 → 클라이언트 등록 → `list_workspaces`로 워크스페이스 확인 → 해당 `workspace_id`로 도구 호출. 호출 예시(curl·JS)는 화면 하단에 있습니다.\n",
  "embedding": null,
  "embedded_at": null,
  "embedding_hash": null,
  "map_x": null,
  "map_y": null,
  "backlinks": [],
  "html_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-api-연결-rest-api",
  "markdown_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-api-연결-rest-api.md"
}