1. Crie seu workspace
Cadastre-se em app.alana.shopping e complete o fluxo de onboarding. Você será guiado através de:
- Nomear seu workspace
- Definir seu setor e tamanho da empresa
- Opcionalmente carregar dados de catálogo de exemplo para explorar
2. Gere uma chave de API
Navegue até Configurações > Chaves de API no painel do seu workspace, ou use o endpoint de configuração após autenticação.
Vá para Chaves de API
Abra as configurações do seu workspace e clique em Chaves de API na barra lateral.
Crie uma chave
Clique em Criar Chave de API, dê um nome (ex: dev-local), e selecione as permissões que você precisa.
Copie a chave
Sua chave de API é mostrada apenas uma vez. Copie e armazene com segurança.
Chaves de API são mostradas apenas no momento da criação. Se você perder sua chave, revogue-a e crie uma nova.
3. Faça sua primeira requisição
Verifique se sua chave funciona buscando as configurações do seu workspace:
curl -X GET "https://app.alana.shopping/api/workspace/{workspaceId}/settings" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
4. Crie sua primeira marca
Marcas organizam seu conteúdo de produtos e carregam especificações de IA (tom, palavras-chave, políticas).
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/brands" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Minha Marca",
"description": "Produtos de estilo de vida premium"
}'
5. Crie um catálogo e adicione produtos
# Crie um catálogo
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/catalogs" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Coleção Primavera 2026",
"brandId": "BRAND_ID_FROM_STEP_4"
}'
# Adicione um produto
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/catalog/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"catalogId": "CATALOG_ID",
"title": "Camiseta Clássica de Algodão",
"description": "Camiseta 100% algodão orgânico",
"brand": "Minha Marca",
"price": 29.99,
"currency": "USD",
"sku": "CCT-001"
}'
curl -X POST "https://app.alana.shopping/api/ai/enhance" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Camiseta 100% algodão orgânico",
"type": "description",
"brandId": "BRAND_ID"
}'
Próximos passos
Mergulho profundo em autenticação
Aprenda sobre chaves de API, autenticação de sessão e escopos.
Importe produtos em massa
Carregue arquivos CSV/Excel com milhares de produtos.
Configure especificações de IA
Configure tom de marca, palavras-chave e políticas para geração de IA.
Explore a API
Playground interativo com todos os 90+ endpoints.
