{
  "id": "d4eecf9f-ae41-4d0a-833d-f8388cbef9e4",
  "slug": "ref/manual/geocare-사용자-매뉴얼-19-rest-api-개발자-시스템-연동용",
  "doc_type": "ref",
  "title": "19 REST API (개발자·시스템 연동용) — GEOcare 사용자 매뉴얼",
  "title_en": null,
  "one_liner": " 19 REST API (개발자·시스템 연동용) 19 REST API (개발자·시스템 연동용) 표준 HTTP로 GEOcare를 외부 시스템·자체 서비스에 연동 개발자·연동 · 경로 /v3/rest api 📌 목적: REST API는 MCP와 똑같은 기능 을 표준 HTTP(GET/POS",
  "summary_bullets": [],
  "body_md": "# 19 REST API (개발자·시스템 연동용)\n\n## 19 REST API (개발자·시스템 연동용)\n\n_표준 HTTP로 GEOcare를 외부 시스템·자체 서비스에 연동_\n\n`개발자·연동 · 경로 /v3/rest-api`\n\n> **📌 목적:** REST API는 MCP와 **똑같은 기능**을 표준 HTTP(GET/POST)로 제공합니다. AI에서도 쓸 수 있지만, 주로 **다른 시스템과의 연동(예: bmp.ai)**·**자체 GEO 데이터 기반 서비스 확장**을 하려는 **개발자**를 위한 것입니다.\n\n### MCP vs REST API — 무엇을 쓸까\n\n| 구분    | MCP                             | REST API                |\n| ----- | ------------------------------- | ----------------------- |\n| 주 사용자 | Claude 등 AI/LLM 에이전트            | 개발자 · 연동 시스템(bmp.ai 등)  |\n| 방식    | JSON-RPC · 자동 도구 인식(tools/list) | 표준 HTTP · OpenAPI 자동 인식 |\n| 연결    | AI 클라이언트 커넥터에 등록                | 코드/도구에서 endpoint 호출     |\n| 인증    | 계정 토큰(공용)                       | 계정 토큰(공용 — 같은 키)        |\n| 대표 용도 | 대화로 조회·실행                       | 시스템 확장·자동화·자체 데이터 활용    |\n\n### 누구를 위한 것인가\n\n* ✅ **연동 시스템 개발자** — bmp.ai 등 사내·외부 시스템이 서버-투-서버로 GEO 데이터를 가져가거나 분석을 트리거\n* ✅ **자체 서비스 확장** — 자사 대시보드·리포트·자동화 파이프라인에 GEOcare 데이터/실행 임베드\n* ✅ **노코드 자동화** — ChatGPT Custom GPT(Actions) · Make · Zapier에 OpenAPI를 import해 바로 호출\n\n### 연동 방법 (3단계)\n\n1. **API 키 발급** — 계정 메뉴 → 'REST API'(/v3/rest-api)에서 발급. MCP 키와 공용(계정 단위).\n2. **Base URL · 인증 설정** — Authorization 헤더에 Bearer 토큰을 담아(또는 쿼리 파라미터 key) Base URL을 호출.\n3. **호출 또는 OpenAPI import** — 직접 HTTP 호출하거나, openapi.json을 ChatGPT Actions · Make · Zapier · Postman에 import해 자동 호출.\n\n### 엔드포인트\n\n| 메서드 · 경로                    | 용도                                                 |\n| --------------------------- | -------------------------------------------------- |\n| `GET /api`                  | 도구 카탈로그(공개) — 사용 가능한 도구 목록                         |\n| `GET/POST /api/call`        | 디스패치형 호출 — {tool, arguments}                       |\n| `GET/POST /api/call/{tool}` | 도구별 경로 — OpenAPI operation 1:1 (arguments = 본문/쿼리) |\n| `GET /openapi.json`         | OpenAPI 3.1 명세(공개) — 외부 도구 자동 import용              |\n| `GET /docs`                 | API 문서(Redoc) — 사람용 매뉴얼                            |\n\n**Base URL:** `https://nntuztaehnywdbttrajy.supabase.co/functions/v1/geocare-user-mcp/api`\n\n### 호출 예제\n\n**① 내 사이트 목록 (가장 먼저)**\n\n* 메서드: **GET**\n* 경로: `{Base URL}/call/list_my_sites`\n* 헤더: `Authorization` 에 Bearer 형식으로 API 키 전달\n\n**② SoM 요약 조회 (site\\_domain 지정)**\n\n* 메서드: **POST**\n* 경로: `{Base URL}/call/get_som_summary`\n* 헤더: `Authorization` (Bearer 형식 API 키), `Content-Type: application/json`\n* 본문(JSON):\n\n```json\n{ \"site_domain\": \"example.com\" }\n```\n\n### 표준 자동 연동 (OpenAPI)\n\n`openapi.json`을 import하면 엔드포인트·파라미터가 자동 인식됩니다 — **ChatGPT Custom GPT(Actions) · Make · Zapier · Postman · bmp.ai**. (= MCP가 AI에게 도구를 자동 인식시키는 것의 REST 표준판)\n\n### 제공 기능(도구)\n\nMCP와 **동일한 도구 세트**(약 41종)를 제공합니다 — 전체 목록은 \\[18 MCP 연결] 페이지의 도구 카탈로그 참조. 라이브 최신 목록은 `GET /openapi.json`.\n\n### 사용 규칙\n\n* 계정 단위 — 호출마다 `site_domain` 지정 (먼저 `list_my_sites`)\n* 실행형(action)은 `\"confirm\": true` 인자 필요\n* 키 노출 시 'REST API' 화면에서 즉시 폐기. 키 = 계정 자격증명\n",
  "related_slugs": [],
  "faq": [],
  "jsonld": null,
  "keywords": [],
  "source_id": "gitbook:ypp1FQXeKh9584utppqp:eB17ylAAeqoaN1aTdBK0",
  "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:40.831494+00:00",
  "updated_at": "2026-08-23T14:32:40.831494+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": true,
      "total": 40,
      "issues": [
        "숫자·규격 같은 검증 가능한 구체가 부족합니다",
        "핵심 요약 불릿이 3개 미만입니다",
        "Q&A 쌍이 3개 미만입니다"
      ],
      "applies": true
    },
    "g3": {
      "pass": true,
      "required": false
    },
    "stage": "1",
    "decided_at": "2026-08-23T14:32:37.773Z"
  },
  "raw_id": "eca3d75d-de2e-4dac-820c-0e3689caf1bd",
  "search_text": "19 REST API (개발자·시스템 연동용) — GEOcare 사용자 매뉴얼   19 REST API (개발자·시스템 연동용) 19 REST API (개발자·시스템 연동용) 표준 HTTP로 GEOcare를 외부 시스템·자체 서비스에 연동 개발자·연동 · 경로 /v3/rest api 📌 목적: REST API는 MCP와 똑같은 기능 을 표준 HTTP(GET/POS  # 19 REST API (개발자·시스템 연동용)\n\n## 19 REST API (개발자·시스템 연동용)\n\n_표준 HTTP로 GEOcare를 외부 시스템·자체 서비스에 연동_\n\n`개발자·연동 · 경로 /v3/rest-api`\n\n> **📌 목적:** REST API는 MCP와 **똑같은 기능**을 표준 HTTP(GET/POST)로 제공합니다. AI에서도 쓸 수 있지만, 주로 **다른 시스템과의 연동(예: bmp.ai)**·**자체 GEO 데이터 기반 서비스 확장**을 하려는 **개발자**를 위한 것입니다.\n\n### MCP vs REST API — 무엇을 쓸까\n\n| 구분    | MCP                             | REST API                |\n| ----- | ------------------------------- | ----------------------- |\n| 주 사용자 | Claude 등 AI/LLM 에이전트            | 개발자 · 연동 시스템(bmp.ai 등)  |\n| 방식    | JSON-RPC · 자동 도구 인식(tools/list) | 표준 HTTP · OpenAPI 자동 인식 |\n| 연결    | AI 클라이언트 커넥터에 등록                | 코드/도구에서 endpoint 호출     |\n| 인증    | 계정 토큰(공용)                       | 계정 토큰(공용 — 같은 키)        |\n| 대표 용도 | 대화로 조회·실행                       | 시스템 확장·자동화·자체 데이터 활용    |\n\n### 누구를 위한 것인가\n\n* ✅ **연동 시스템 개발자** — bmp.ai 등 사내·외부 시스템이 서버-투-서버로 GEO 데이터를 가져가거나 분석을 트리거\n* ✅ **자체 서비스 확장** — 자사 대시보드·리포트·자동화 파이프라인에 GEOcare 데이터/실행 임베드\n* ✅ **노코드 자동화** — ChatGPT Custom GPT(Actions) · Make · Zapier에 OpenAPI를 import해 바로 호출\n\n### 연동 방법 (3단계)\n\n1. **API 키 발급** — 계정 메뉴 → 'REST API'(/v3/rest-api)에서 발급. MCP 키와 공용(계정 단위).\n2. **Base URL · 인증 설정** — Authorization 헤더에 Bearer 토큰을 담아(또는 쿼리 파라미터 key) Base URL을 호출.\n3. **호출 또는 OpenAPI import** — 직접 HTTP 호출하거나, openapi.json을 ChatGPT Actions · Make · Zapier · Postman에 import해 자동 호출.\n\n### 엔드포인트\n\n| 메서드 · 경로                    | 용도                                                 |\n| --------------------------- | -------------------------------------------------- |\n| `GET /api`                  | 도구 카탈로그(공개) — 사용 가능한 도구 목록                         |\n| `GET/POST /api/call`        | 디스패치형 호출 — {tool, arguments}                       |\n| `GET/POST /api/call/{tool}` | 도구별 경로 — OpenAPI operation 1:1 (arguments = 본문/쿼리) |\n| `GET /openapi.json`         | OpenAPI 3.1 명세(공개) — 외부 도구 자동 import용              |\n| `GET /docs`                 | API 문서(Redoc) — 사람용 매뉴얼                            |\n\n**Base URL:** `https://nntuztaehnywdbttrajy.supabase.co/functions/v1/geocare-user-mcp/api`\n\n### 호출 예제\n\n**① 내 사이트 목록 (가장 먼저)**\n\n* 메서드: **GET**\n* 경로: `{Base URL}/call/list_my_sites`\n* 헤더: `Authorization` 에 Bearer 형식으로 API 키 전달\n\n**② SoM 요약 조회 (site\\_domain 지정)**\n\n* 메서드: **POST**\n* 경로: `{Base URL}/call/get_som_summary`\n* 헤더: `Authorization` (Bearer 형식 API 키), `Content-Type: application/json`\n* 본문(JSON):\n\n```json\n{ \"site_domain\": \"example.com\" }\n```\n\n### 표준 자동 연동 (OpenAPI)\n\n`openapi.json`을 import하면 엔드포인트·파라미터가 자동 인식됩니다 — **ChatGPT Custom GPT(Actions) · Make · Zapier · Postman · bmp.ai**. (= MCP가 AI에게 도구를 자동 인식시키는 것의 REST 표준판)\n\n### 제공 기능(도구)\n\nMCP와 **동일한 도구 세트**(약 41종)를 제공합니다 — 전체 목록은 \\[18 MCP 연결] 페이지의 도구 카탈로그 참조. 라이브 최신 목록은 `GET /openapi.json`.\n\n### 사용 규칙\n\n* 계정 단위 — 호출마다 `site_domain` 지정 (먼저 `list_my_sites`)\n* 실행형(action)은 `\"confirm\": true` 인자 필요\n* 키 노출 시 'REST API' 화면에서 즉시 폐기. 키 = 계정 자격증명\n",
  "embedding": null,
  "embedded_at": null,
  "embedding_hash": null,
  "backlinks": [],
  "html_url": "https://bizspring.ai/kb/ref/manual/geocare-사용자-매뉴얼-19-rest-api-개발자-시스템-연동용",
  "markdown_url": "https://bizspring.ai/kb/ref/manual/geocare-사용자-매뉴얼-19-rest-api-개발자-시스템-연동용.md"
}