Pular para o conteúdo principal

​
Visão geral

Alana Shopping integra com plataformas de e-commerce e provedores de dados para sincronizar dados de produtos bidirecionalmente. Integrações usam OAuth para autorização segura e suportam cronogramas de sincronização automática.

​
Conectando uma plataforma

1

Autorizar

Inicie o fluxo OAuth para conectar sua conta de e-commerce:
curl -X POST "https://app.alana.shopping/api/integrations/authorize" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": "shopify", "workspaceId": "ws_..."}'
Isso retorna uma URL de autorização. Redirecione o usuário para completar OAuth.
2

Callback

Após autorização, a plataforma redireciona para nossa URL de callback com credenciais que são armazenadas com segurança.
3

Sincronizar

Acione uma sincronização inicial para puxar produtos da plataforma conectada:
curl -X POST "https://app.alana.shopping/api/integrations/sync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId": "ws_...", "platform": "shopify"}'

​
Verificando status de integração

curl "https://app.alana.shopping/api/integrations/status" \
  -H "Authorization: Bearer YOUR_API_KEY"
Retorna o status da conexão, horário da última sincronização e quaisquer erros para cada integração configurada.

​
Monitoramento de sincronização

Após acionar uma sincronização, monitore seu progresso: 
curl "https://app.alana.shopping/api/integrations/sync/status" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Integração MCP

Para integrações avançadas, Alana Shopping suporta o Model Context Protocol (MCP):
  • Inbound — receba lotes de produtos via /api/mcp/inbound
  • Assinaturas de feed — assine feeds de produtos via /api/mcp/feed/{platform}
  • Busca — consulte através de fontes integradas via /api/mcp/search
Last modified on February 16, 2026