본문으로 건너뛰기

API

개발자

ERP, 창고, 생산 시스템 연동과 에이전트 및 스캐너용 제품 데이터를 위한 Itemoo 공개 API입니다. 문서는 요청을 처리하는 코드와 동일한 코드에서 생성되므로 API와 어긋날 수 없습니다.

3분 만에 첫 호출하기

  1. Itemoo 대시보드에서 통합 → API 키를 열고 필요한 범위로 키를 생성하세요. 키는 한 번만 표시됩니다.

  2. 연결 확인: Authorization: Bearer itm_… 헤더와 함께 GET /v1/ping

  3. 재고를 전송하거나 주문을 가져오세요. 아래 모든 엔드포인트에 예시가 있습니다. 주문 알림은 대시보드의 같은 위치에서 설정합니다.

대시보드에서 키 생성 →

cURL

curl 'https://itemoo.eu/v1/ping' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

AI 어시스턴트용 MCP 서버

Model Context Protocol을 사용하면 AI 어시스턴트(Claude, ChatGPT 등)가 별도의 연동 개발 없이 Itemoo를 이용할 수 있습니다. 어시스턴트가 도구와 매개변수를 스스로 찾아냅니다.

글로벌 MCP — 제품과 쇼핑

제품, 브랜드, 회사, 판매처, 문서 검색, 모든 정보의 출처가 표시된 제품 데이터, 리콜, 문서, 결제 링크가 포함된 장바구니. 로그인 없이 사용합니다. 검색에는 노출에 동의한 브랜드만 포함되며, 결제는 항상 브랜드 스토어에서 이루어집니다.

서버 주소

https://itemoo.eu/mcp

도구

  • search — Search products, brands, companies, sellers and articles
  • brand_get — Brand profile
  • product_lookup — Product data with provenance
  • recall_status — Recall and safety notice status
  • documents_list — Product documents
  • sellers_for_product — Where to buy
  • cart_create — Prepare a cart in a brand shop

브랜드 MCP — 귀사 브랜드의 데이터

카탈로그, 배치, 스캔, 규정 준수 누락, 판매와 재고 수치 — 고객 개인정보는 포함되지 않습니다. 브랜드 소유자가 별도로 동의하면 어시스턴트가 제품 페이지, 게시물, 기사, 캠페인, 브랜드 웹사이트의 초안도 만들며, 게시는 항상 사람이 패널에서 합니다. 각 연결은 팀의 한 사람과 하나의 브랜드에 속합니다.

귀사 브랜드: 패널에 표시된 주소

https://itemoo.eu/mcp/b/{brand}

  1. 브랜드 소유자가 패널의 통합 → AI 어시스턴트(MCP)에서 기능을 켜고 연결할 수 있는 역할을 선택합니다.

  2. 어시스턴트에 패널에 표시된 브랜드 서버 주소로 사용자 지정 커넥터를 추가합니다.

  3. Itemoo에 로그인하고 접근을 승인합니다. 어시스턴트는 귀하의 역할이 허용하는 정보만 볼 수 있으며, 연결은 패널에서 해제할 수 있습니다.

도구

  • products_list — Products of the brand
  • products_get — Product details
  • batches_list — Batches (LOT)
  • codes_stats — QR code and unit statistics
  • scans_analytics — Scan analytics
  • plan_usage — Plan and usage
  • catalog_gaps — Catalogue gaps
  • translations_status — Translation status
  • orders_summary — Orders summary
  • customers_summary — Customers summary
  • stock_overview — Stock overview
  • promotions_list — Promotions
  • marketplace_status — Marketplace channels
  • team_overview — Team overview
  • billing_summary — Billing summary
  • product_page_get — Product page draft for editing
  • product_draft_create — Create product drafts
  • product_page_draft_patch — Edit a product page draft
  • site_draft_get — Brand website draft
  • site_draft_patch — Edit the brand website draft
  • publications_list — Social media posts
  • publication_get — One post
  • publication_draft_upsert — Create or edit a post draft
  • articles_list — Knowledge articles
  • article_get — One article
  • article_draft_upsert — Create or edit an article draft
  • campaigns_list — Push and newsletter campaigns
  • campaign_get — One campaign
  • campaign_draft_upsert — Create or edit a campaign draft
  • draft_discard — Discard your own draft

cURL

curl -X POST 'https://itemoo.eu/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"resin"}}}'

가이드

단계별 안내: ERP 연결, 웹훅, 제품 여권.

가이드가 곧 제공될 예정입니다.