> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral da Pipeline API

> Endpoints REST para acionar os estágios Bronze → Silver → Gold do pipeline e gerenciar configurações de pipeline do workspace.

## 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](/concepts/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

| Tier       | Requisições por minuto |
| ---------- | ---------------------- |
| Free       | 20                     |
| Pro        | 120                    |
| Business   | 600                    |
| Enterprise | Customizado            |

***

## Endpoints

<CardGroup cols={2}>
  <Card title="Lote Silver" icon="filter" href="/api-reference/pipeline/batch-silver">
    `POST /batch/silver` — normalizar uma seleção ou catálogo inteiro
  </Card>

  <Card title="Lote Gold" icon="star" href="/api-reference/pipeline/batch-gold">
    `POST /batch/gold` — pontuar uma seleção ou catálogo inteiro
  </Card>

  <Card title="Configurações do Pipeline" icon="settings" href="/api-reference/pipeline/settings">
    `GET/PUT /settings/pipeline` — configurar mapeamentos e pesos
  </Card>
</CardGroup>

***

## Função de score

O score Gold é uma soma ponderada em 7 estágios. Pesos padrão:

| Estágio      | Peso |
| ------------ | ---- |
| Identidade   | 20   |
| Taxonomia    | 15   |
| Conteúdo     | 25   |
| Mídia        | 20   |
| Precificação | 10   |
| Atributos    | 5    |
| SEO          | 5    |

***

## Respostas de erro

| Código                     | Status HTTP | Descrição                                              |
| -------------------------- | ----------- | ------------------------------------------------------ |
| `CATALOG_NOT_FOUND`        | 404         | ID do catálogo não encontrado no workspace             |
| `INSUFFICIENT_PERMISSIONS` | 403         | Chave API sem permissão necessária                     |
| `RATE_LIMIT_EXCEEDED`      | 429         | Muitas requisições — aguarde e tente novamente         |
| `JOB_ALREADY_RUNNING`      | 409         | Um job em lote já está em andamento para este catálogo |
| `VALIDATION_ERROR`         | 422         | Corpo da requisição falhou na validação                |