Pular para o conteúdo principal

​
Endpoint

POST /api/workspace/{workspaceId}/catalogs/{catalogId}/batch/silver
Aciona o estágio de normalização Silver para uma seleção de produtos ou o catálogo inteiro. O Silver normaliza valores de campos, mapeia campos de origem para o schema do Alana, valida URLs de imagens e detecta produtos duplicados.

​
Parâmetros de path

ParâmetroTipoObrigatórioDescrição
workspaceIdstringSimSeu ID de workspace
catalogIdstringSimO catálogo a processar

​
Corpo da requisição

{
  "productIds": ["prod_abc", "prod_def"],
  "scope": "selection"
}
CampoTipoObrigatórioDescrição
productIdsstring[]NãoIDs de produtos a processar. Obrigatório quando scope é "selection"
scopestringSim"selection" ou "all". Quando "all", productIds é ignorado

​
Resposta

{
  "results": [
    {
      "productId": "prod_abc",
      "status": "success",
      "fieldsNormalized": 4,
      "duplicateOf": null,
      "urlsValidated": 3
    },
    {
      "productId": "prod_def",
      "status": "success",
      "fieldsNormalized": 2,
      "duplicateOf": "prod_xyz",
      "urlsValidated": 1
    }
  ],
  "processed": 2,
  "duration_ms": 1240
}

​
Exemplos

curl -X POST "https://app.alana.shopping/api/workspace/ws_123/catalogs/cat_456/batch/silver" \
  -H "Authorization: Bearer sk_live_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{
    "productIds": ["prod_abc", "prod_def"],
    "scope": "selection"
  }'

​
Respostas de erro

Status HTTPCódigoDescrição
400VALIDATION_ERRORscope ausente ou inválido
403INSUFFICIENT_PERMISSIONSChave API sem catalogs:write
404CATALOG_NOT_FOUNDCatálogo não existe no workspace
409JOB_ALREADY_RUNNINGUm job Silver ou Gold já está em andamento
429RATE_LIMIT_EXCEEDEDAguarde o valor do header Retry-After
Last modified on March 18, 2026