Jumpseller

Jumpseller API 文档

Jumpseller 电商平台 API 的官方 OpenAPI 3.0.3 规范。

API 概览

Jumpseller API 可让你以编程方式创建和管理在线商店，涵盖：

• 商店 - 创建、配置和管理在线商店
• 产品 - 完整的 CRUD 操作，支持变体、图片、类别和自定义字段
• 订单 - 创建、更新、搜索和履行订单
• 客户 - 管理客户账户和群组
• 配送 - 配置配送方式和费率
• 支付 - 设置支付网关
• 主题 - 应用和自定义商店主题
• Webhooks - 订阅商店事件
• 页面和类别 - 管理商店内容和导航

快速开始

基础 URL： https://api.jumpseller.com/v1

身份验证： 使用你的登录名和身份验证令牌进行 Basic 身份验证（可在 Admin Panel > Account 中找到）。

curl -u YOUR_LOGIN:YOUR_AUTHTOKEN https://api.jumpseller.com/v1/products.json

资源

• OpenAPI 规范 - 完整的 API 规范- OpenAPI 精简版 - 前 30 个端点，不含代码示例（适用于 ChatGPT、Copilot 和其他存在端点数量限制的 AI 平台）
• 在线 API 参考 - 交互式文档
• OAuth 2 指南 - 用于构建 Jumpseller 应用

MCP 服务（AI Agent）

Jumpseller 提供专用的 Model Context Protocol (MCP) 服务，为 Claude、Cursor、Windsurf 和 GitHub Copilot 等 AI Agent 提供 20 个商店管理工具。

服务 URL： https://mcp.jumpseller.com

传输方式： 可流式传输的 HTTP（通过 POST 进行 JSON-RPC，无状态）

文档： jumpseller.com/support/mcp-server

快速设置

{
  "mcpServers": {
    "jumpseller": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.jumpseller.com/",
        "--header", "X-LOGIN-KEY:YOUR_LOGIN_KEY",
        "--header", "X-AUTH-TOKEN:YOUR_AUTH_TOKEN"
      ]
    }
  }
}

将此内容添加到 claude_desktop_config.json（Claude）、.cursor/mcp.json（Cursor）或 ~/.codeium/windsurf/mcp_config.json（Windsurf）中。可从 Jumpseller Admin > Settings > API 获取凭据。

可用工具

领域	工具	访问权限
产品	list_products、get_product、search_products、create_product、update_product、delete_product	读/写
订单	list_orders、get_order、search_orders、update_order	读/写
客户	list_customers、get_customer、search_customers	只读
类别	list_categories、create_category、delete_category	读/写
页面	list_pages、create_page、delete_page	读/写
商店	get_store_info	只读

产品工具支持变体（尺码、颜色）、图片和类别。工具会通过 tools/list 自动发现。

身份验证

• API 令牌： X-LOGIN-KEY + X-AUTH-TOKEN 标头（适用于商店所有者）
• OAuth 2.0： 使用带有范围权限的 Authorization: Bearer <token>（适用于第三方应用）。请参阅 OAuth 2 指南。

基于 OpenAPI 的 MCP（替代方案）

你也可以通过 OpenAPI 规范连接，以使用完整的 API 功能（109 个端点）：

npx openmcp install https://api.jumpseller.com/swagger.json --client cursor

速率限制

• 每分钟 800 个请求
• 每秒 20 个请求
• 每个响应都包含速率限制标头

品牌与法律信息

• 徽标： https://jumpseller.com/images/brand/jumpseller-logo-26.svg
• 支持： [email protected]
• 服务条款： https://jumpseller.com/terms/

许可证

本文档由 Jumpseller 提供，供开发者和 AI Agent 用于构建与该平台集成的应用。