> ## 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.

# Início Rápido

> Comece a usar a API do Alana Shopping B2B em menos de 5 minutos.

## 1. Crie seu workspace

Cadastre-se em [app.alana.shopping](https://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.

<Steps>
  <Step title="Vá para Chaves de API">
    Abra as configurações do seu workspace e clique em **Chaves de API** na barra lateral.
  </Step>

  <Step title="Crie uma chave">
    Clique em **Criar Chave de API**, dê um nome (ex: `dev-local`), e selecione as permissões que você precisa.
  </Step>

  <Step title="Copie a chave">
    Sua chave de API é mostrada **apenas uma vez**. Copie e armazene com segurança.
  </Step>
</Steps>

<Warning>
  Chaves de API são mostradas apenas no momento da criação. Se você perder sua chave, revogue-a e crie uma nova.
</Warning>

## 3. Faça sua primeira requisição

Verifique se sua chave funciona buscando as configurações do seu workspace:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.alana.shopping/api/workspace/{workspaceId}/settings" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    `https://app.alana.shopping/api/workspace/${workspaceId}/settings`,
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
      },
    }
  );
  const workspace = await response.json();
  console.log(workspace);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      f"https://app.alana.shopping/api/workspace/{workspace_id}/settings",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
  )
  print(response.json())
  ```
</CodeGroup>

## 4. Crie sua primeira marca

Marcas organizam seu conteúdo de produtos e carregam especificações de IA (tom, palavras-chave, políticas).

```bash theme={null}
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

```bash theme={null}
# 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"
  }'
```

## 6. Gere conteúdo com IA

Use o motor de IA para melhorar a descrição do seu produto, com contexto consciente da marca:

```bash theme={null}
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

<CardGroup cols={2}>
  <Card title="Mergulho profundo em autenticação" icon="lock" href="/pt/authentication">
    Aprenda sobre chaves de API, autenticação de sessão e escopos.
  </Card>

  <Card title="Importe produtos em massa" icon="upload" href="/pt/guides/product-import">
    Carregue arquivos CSV/Excel com milhares de produtos.
  </Card>

  <Card title="Configure especificações de IA" icon="sparkles" href="/pt/concepts/ai-engine">
    Configure tom de marca, palavras-chave e políticas para geração de IA.
  </Card>

  <Card title="Explore a API" icon="code" href="/pt/api-reference/overview">
    Playground interativo com todos os 90+ endpoints.
  </Card>
</CardGroup>