Jumpseller
Gerencie sua loja de e-commerce Jumpseller com IA. Crie produtos com variações, processe pedidos, pesquise clientes e organize seu catálogo.
Documentação
Documentação da API Jumpseller
Especificação oficial OpenAPI 3.0.3 para a API da plataforma de ecommerce Jumpseller.
Visão Geral da API
A API Jumpseller permite criar e gerenciar lojas online programaticamente. Ela abrange:
- Lojas - Criar, configurar e gerenciar lojas online
- Produtos - CRUD completo com variantes, imagens, categorias e campos personalizados
- Pedidos - Criar, atualizar, buscar e atender pedidos
- Clientes - Gerenciar contas e grupos de clientes
- Envio - Configurar métodos e taxas de envio
- Pagamentos - Configurar gateways de pagamento
- Temas - Aplicar e personalizar temas da loja
- Webhooks - Assinar eventos da loja
- Páginas e Categorias - Gerenciar conteúdo e navegação da loja
Início Rápido
URL Base: https://api.jumpseller.com/v1
Autenticação: Autenticação básica com seu login e token de autenticação (encontrado no seu Painel Administrativo > Conta).
curl -u YOUR_LOGIN:YOUR_AUTHTOKEN https://api.jumpseller.com/v1/products.json
Recursos
- OpenAPI Spec - Especificação completa da API- OpenAPI Light - Top 30 endpoints, sem exemplos de código (para ChatGPT, Copilot e outras plataformas de IA com limites de endpoints)
- Referência da API ao Vivo - Documentação interativa
- Guia OAuth 2 - Para construir aplicativos Jumpseller
Servidor MCP (Agentes de IA)
A Jumpseller fornece um servidor dedicado Model Context Protocol (MCP) que expõe 20 ferramentas de gerenciamento de loja para agentes de IA como Claude, Cursor, Windsurf e GitHub Copilot.
URL do Servidor: https://mcp.jumpseller.com
Transporte: HTTP Streamable (JSON-RPC sobre POST, sem estado)
Documentação: jumpseller.com/support/mcp-server
Configuração Rápida
{
"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"
]
}
}
}
Adicione isso ao claude_desktop_config.json (Claude), .cursor/mcp.json (Cursor) ou ~/.codeium/windsurf/mcp_config.json (Windsurf). Obtenha suas credenciais em Jumpseller Admin > Configurações > API.
Ferramentas Disponíveis
| Área | Ferramentas | Acesso |
|---|---|---|
| Produtos | list_products, get_product, search_products, create_product, update_product, delete_product | leitura/escrita |
| Pedidos | list_orders, get_order, search_orders, update_order | leitura/escrita |
| Clientes | list_customers, get_customer, search_customers | leitura |
| Categorias | list_categories, create_category, delete_category | leitura/escrita |
| Páginas | list_pages, create_page, delete_page | leitura/escrita |
| Loja | get_store_info | leitura |
As ferramentas de produtos suportam variantes (tamanhos, cores), imagens e categorias. As ferramentas são descobertas automaticamente via tools/list.
Autenticação
- Token de API:
X-LOGIN-KEY+X-AUTH-TOKENcabeçalhos (para proprietários de loja) - OAuth 2.0:
Authorization: Bearer <token>com permissões escopadas (para aplicativos de terceiros). Veja Guia OAuth 2.
MCP baseado em OpenAPI (alternativa)
Você também pode se conectar via especificação OpenAPI para cobertura completa da API (109 endpoints):
npx openmcp install https://api.jumpseller.com/swagger.json --client cursor
Limites de Taxa
- 800 requisições por minuto
- 20 requisições por segundo
- Cabeçalhos de limite de taxa incluídos em cada resposta
Marca e Legal
- Logotipo: https://jumpseller.com/images/brand/jumpseller-logo-26.svg
- Suporte: support@jumpseller.com
- Termos de Serviço: https://jumpseller.com/terms/
Licença
Esta documentação é fornecida pela Jumpseller para uso por desenvolvedores e agentes de IA que criam integrações com a plataforma.