Chuyển đến nội dung

API

Nhà phát triển

API công khai của Itemoo cho ERP, kho hàng và sản xuất, cùng dữ liệu sản phẩm cho tác tử và máy quét. Tài liệu được tạo từ chính mã xử lý yêu cầu.

Lệnh gọi đầu tiên trong ba phút

  1. Trong bảng điều khiển Itemoo, mở Tích hợp → Khóa API và tạo khóa với các phạm vi quyền bạn cần. Bạn chỉ thấy khóa một lần.

  2. Kiểm tra kết nối: GET /v1/ping với tiêu đề Authorization: Bearer itm_…

  3. Gửi tồn kho hoặc lấy đơn hàng — mỗi endpoint bên dưới đều có ví dụ. Thông báo đơn hàng được thiết lập tại cùng vị trí trong bảng điều khiển.

Tạo khóa trong bảng điều khiển →

cURL

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

Máy chủ MCP cho trợ lý AI

Model Context Protocol cho phép trợ lý AI (Claude, ChatGPT và các trợ lý khác) dùng Itemoo mà không cần tích hợp riêng: trợ lý tự tìm ra các công cụ và tham số của chúng.

MCP toàn cầu — sản phẩm và mua sắm

Tìm kiếm sản phẩm, thương hiệu, công ty, người bán và bài viết; dữ liệu sản phẩm kèm nguồn của từng thông tin, thu hồi, tài liệu và giỏ hàng có liên kết thanh toán. Không cần đăng nhập. Kết quả tìm kiếm chỉ gồm các thương hiệu đã đồng ý; người mua luôn thanh toán tại cửa hàng của thương hiệu.

Địa chỉ máy chủ

https://itemoo.eu/mcp

Công cụ

  • 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 thương hiệu — dữ liệu thương hiệu của bạn

Danh mục, lô hàng, lượt quét, thiếu sót tuân thủ, doanh số và tồn kho dưới dạng số liệu — không có dữ liệu cá nhân của khách hàng. Khi chủ thương hiệu đồng ý riêng, trợ lý còn tạo bản nháp trang sản phẩm, bài đăng, bài viết, chiến dịch và trang web thương hiệu — việc xuất bản luôn do một người thực hiện trong bảng điều khiển. Mỗi kết nối thuộc về một người trong nhóm và một thương hiệu.

Thương hiệu của bạn: địa chỉ trong bảng điều khiển

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

  1. Chủ thương hiệu bật tính năng trong bảng điều khiển tại Tích hợp → Trợ lý AI (MCP) và chọn các vai trò được phép kết nối.

  2. Trong trợ lý, thêm trình kết nối tùy chỉnh với địa chỉ máy chủ thương hiệu hiển thị trong bảng điều khiển.

  3. Đăng nhập Itemoo và chấp thuận quyền truy cập. Trợ lý chỉ thấy những gì vai trò của bạn cho phép; bạn có thể thu hồi kết nối trong bảng điều khiển.

Công cụ

  • 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"}}}'

Hướng dẫn

Từng bước: kết nối ERP, webhook, hộ chiếu sản phẩm.

Các hướng dẫn sẽ sớm có mặt.