Pular para o conteúdo principal

​
Visão Geral

A Pipeline API fornece controle programático sobre os estágios de processamento Bronze, Silver e Gold para dados de produto. Use estes endpoints para acionar normalização e scoring em lote, monitorar progresso de jobs e configurar o comportamento do pipeline.

​
Arquitetura

O pipeline segue uma arquitetura medalhão de três estágios (veja Data Pipeline para a visão conceitual completa): 
Bronze (ingestão) → Silver (normalizar) → Gold (pontuar) → Repositório
Cada estágio é acionável independentemente. O Bronze é automático na importação; Silver e Gold requerem acionamento explícito a menos que o auto-trigger esteja configurado.

​
URL Base

Todos os endpoints da Pipeline API são escopados a um workspace e catálogo: 
https://app.alana.shopping/api/workspace/{workspaceId}/catalogs/{catalogId}/
Para configurações do pipeline (nível de workspace): 
https://app.alana.shopping/api/workspace/{workspaceId}/settings/pipeline

​
Autenticação

Todos os endpoints requerem um Bearer token: 
Authorization: Bearer sk_live_sua_chave_api

​
Rate limits

TierRequisições por minuto
Free20
Pro120
Business600
EnterpriseCustomizado

​
Endpoints

Lote Silver

POST /batch/silver — normalizar uma seleção ou catálogo inteiro

Lote Gold

POST /batch/gold — pontuar uma seleção ou catálogo inteiro

Configurações do Pipeline

GET/PUT /settings/pipeline — configurar mapeamentos e pesos

​
Função de score

O score Gold é uma soma ponderada em 7 estágios. Pesos padrão:
EstágioPeso
Identidade20
Taxonomia15
Conteúdo25
Mídia20
Precificação10
Atributos5
SEO5

​
Respostas de erro

CódigoStatus HTTPDescrição
CATALOG_NOT_FOUND404ID do catálogo não encontrado no workspace
INSUFFICIENT_PERMISSIONS403Chave API sem permissão necessária
RATE_LIMIT_EXCEEDED429Muitas requisições — aguarde e tente novamente
JOB_ALREADY_RUNNING409Um job em lote já está em andamento para este catálogo
VALIDATION_ERROR422Corpo da requisição falhou na validação
Last modified on March 18, 2026