Changelog

​

Março de 2026

​

v1.8.1 — Hardening do Pipeline + Marketplace Hub

• Idempotência Bronze: importações duplicadas da mesma fonte são silenciosamente ignoradas via chave hash source_identifier — re-executar uma importação não cria produtos duplicados
• Pontuação de otimização unificada: optimization_score agora é campo de nível raiz no objeto produto; score_history rastreia a progressão completa de 0 a 100 ao longo das execuções do pipeline
• API de configurações do pipeline: GET/PUT /api/workspace/{workspaceId}/settings/pipeline — configure mapeamentos de campos Silver, pesos da rubrica Gold e comportamento de auto-trigger por workspace

• Paginação: GET /api/hub/catalogs agora retorna paginação baseada em cursor (params after, limit); primeira página padrão com 20 catálogos
• Endpoint de preview: GET /api/hub/catalogs/{catalogId}/preview — inspecione metadados do catálogo e uma amostra de produtos antes de clonar ou assinar
• Assinar + sincronizar: POST /api/hub/catalogs/{catalogId}/subscribe cria uma assinatura ativa; POST /api/hub/subscriptions/{subscriptionId}/sync dispara atualização manual
• Resolução de conflitos: GET /api/hub/subscriptions/{subscriptionId}/conflicts lista conflitos de campo; PATCH resolve conflitos individuais com keep_local, accept_remote ou manual_review
• Analytics do publisher: GET /api/hub/catalogs/{catalogId}/analytics retorna contagem de assinantes, contagem de clones e tendências semanais de visualizações (até 90 dias)
• Versionamento: publicar uma nova versão de um catálogo assinado dispara webhooks catalog.version.published para todos os assinantes ativos

• Integração Bright Data promovida de beta para GA; API de cobrança real conectada (uso cobrado por crédito de scrape consumido)
• Webhooks de importação por URL: eventos url_import.completed e url_import.failed agora entregues com payload completo do produto no sucesso
• Endpoint de entrega de dataset: POST /api/workspace/{workspaceId}/datasets/ingest aceita payloads de datasets Bright Data diretamente

• llms.txt publicado em https://docs.alana.shopping/llms.txt — resumo da plataforma legível por máquina para janelas de contexto de LLMs
• Feed API: streaming NDJSON agora suportado via cabeçalho Accept: application/x-ndjson em GET /api/mcp/feed/{platform}
• Catálogo unificado de erros: todos os erros da API agora incluem error_code (ex: CATALOG_NOT_PUBLISHED, RATE_LIMIT_EXCEEDED) — veja Referência de Erros
• MCP Tools: filtragem de ferramentas via param ?tools= no connect SSE — assine apenas as categorias de ferramenta que você precisa
• Quickstarts de plataforma adicionados para Shopify, WooCommerce e storefronts personalizados
• Webhooks de feed: POST /api/v1/feeds/{platform}/webhooks — registre endpoints para receber eventos feed.updated
• Analytics de feed: GET /api/v1/feeds/{platform}/analytics — métricas de consumo (requisições, taxa de cache hit, taxa de erro, principais consumidores)
• Coleção Postman publicada: importe via https://docs.alana.shopping/postman.json

​

v1.8.0 — Integração Bright Data + Pipeline Bronze/Silver/Gold

• Cinco clientes Bright Data integrados: ProductScraper, WebUnlocker, DatasetDelivery, ProxyManager, SearchScraper
• Importação por URL: POST /api/workspace/{workspaceId}/url-import/jobs — envie uma URL de página de produto; Bright Data faz scraping e extrai dados estruturados
• Web scraping com bypass automático de CAPTCHA, rotação de proxy residencial e renderização JavaScript
• Polling assíncrono de status de job e entrega de webhook na conclusão

• Estágio Bronze: ingestão bruta de produtos com chave de idempotência (source_identifier) — previne importações duplicadas da mesma fonte em execuções repetidas
• Estágio Silver: normalização de campos (mapeia nomes de colunas arbitrários para o schema Alana), detecção de duplicatas no catálogo, validação de URLs de imagem
• Estágio Gold: scoring de rubrica de otimização 7 dimensões (0–100) abrangendo identidade, conteúdo, mídia, precificação, disponibilidade, SEO e conformidade; retorna pontuação + lista de gaps por produto
• Estágios do pipeline executam automaticamente após importação (configurável) ou sob demanda via Ações em Lote

• Novo painel de Ações em Lote na visualização de catálogo: execute normalização Silver ou scoring Gold em uma seleção ou catálogo inteiro
• Indicador de progresso em tempo real com atualizações de status por produto
• Resumo de erros com exportação de detalhe em nível de linha (CSV)

• Novo painel de Configurações do Pipeline nas configurações do workspace:
  • Mapeamentos Silver: mapeie nomes de colunas personalizados para campos Alana padrão
  • Pesos Gold: ajuste os pesos da rubrica por dimensão (identidade, conteúdo, mídia, precificação, disponibilidade, SEO, conformidade)
  • Auto-trigger: configure se Silver executa automaticamente após Bronze, e se Gold executa após Silver

​

v1.7.0 — Excelência em Distribuição

• BREAKING: parâmetro de query ?key= removido de todos os endpoints /api/v1/*. Chaves de API devem ser passadas via cabeçalho de requisição x-api-key. Chaves em URLs são visíveis em logs, cabeçalhos Referer e histórico do navegador — esta mudança melhora a segurança para todos os consumidores da Search API.
  • Migração: substitua GET /api/v1/search?key=ak_xxx por GET /api/v1/search + cabeçalho x-api-key: ak_xxx.
  • Endpoints afetados: /api/v1/search, /api/v1/autocomplete, /api/v1/browse, /api/v1/recommend, /api/v1/recommendations/*, /api/v1/events, /api/v1/analytics/*, /api/v1/serving-configs/*, /api/v1/facets/*, /api/v1/synonyms/*, /api/v1/boost-rules/*, /api/v1/language, /api/v1/pipeline/status, /api/v1/bandit/state, /api/v1/cache/metrics

• Hardening de validação de entrada em GET /api/mcp/feed/[platform]:
  • Parâmetro ?q=: caracteres de controle removidos, máximo de 500 caracteres aplicado (400 em violação)
  • Parâmetro ?catalog_id=: formato UUID validado (400 em formato inválido)

• Respostas autenticadas com chaves API legadas agora incluem cabeçalhos de depreciação:
  • X-Api-Key-Deprecated: true
  • X-Deprecation-Info: https://docs.alana.shopping/pt/authentication#m2m-migration
  • Deprecation: true (RFC 8594)
• Migre para tokens Auth0 M2M: veja o guia de migração

• Todas as respostas da API incluem X-Request-Id para rastreamento distribuído
• X-Request-Id ecoado do upstream quando o cliente o envia; gerado (UUID v4) caso contrário
• Canal 1: 60 req/min por chave API; 429 inclui X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After
• Canal 3: 200 req/min por chave + 50 req/min por chave+IP; aplicação em dois níveis

​

Fevereiro de 2026

​

v1.0.0 — Disponibilidade Geral

• Gerenciamento de workspace com RBAC completo (owner, admin, editor, viewer)
• Segurança em nível de linha em todos os recursos
• Assistente de onboarding com carregamento de dados de exemplo
• Suporte a domínio personalizado e branding de workspace
• Exportação de dados e exclusão de conta em conformidade com GDPR
• Registro de auditoria abrangente (mais de 38 tipos de ação)

• Criar, publicar, bifurcar e mesclar catálogos
• CRUD de produtos com pontuação de otimização (0–100)
• Validação de prontidão de feed para Google Shopping e Meta Commerce
• Importação em lote de arquivos CSV e Excel
• Endpoint público de feed de produtos para catálogos publicados

• Geração de conteúdo com consciência de marca via abstração LiteLLM
• Chat AI Canvas com RAG (especificações de marca + contexto de produto)
• Geração de texto para descrições, títulos e bullet points
• Aprimoramento de conteúdo com alinhamento de gramática, tom e palavras-chave
• Especificações de AI por marca: tom, palavras-chave, políticas, público

• Quatro planos: Standard, Pro, Business, Enterprise
• Checkout, assinaturas e portal do cliente com Stripe
• Rastreamento de uso com alertas configuráveis
• Histórico de faturas e download em PDF

• Conexões de plataforma baseadas em OAuth
• Sincronização bidirecional de produtos com plataformas de e-commerce
• Suporte ao protocolo MCP (batches de entrada, assinaturas de feed, busca)
• Integração de suporte ao cliente com Intercom

• API REST com mais de 90 endpoints e playground interativo
• Gerenciamento de chave de API com permissões granulares
• Paginação baseada em cursor em todos os endpoints de listagem
• Respostas de erro estruturadas com códigos de erro
• Endpoints de health e readiness para monitoramento

• Supabase Auth com email/senha, magic links e OAuth
• Timeouts de sessão configuráveis e aplicação de 2FA
• Lista de permissão de IP para acesso à API
• Verificação de assinatura de webhook do Stripe
• Logout forçado em nível de workspace