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

> API REST com mais de 90 endpoints para acesso programático ao Alana Shopping B2B.

## URL Base

```
https://app.alana.shopping/api
```

## Autenticação

Todas as requisições à API requerem autenticação via token Bearer. Inclua sua chave de API no cabeçalho `Authorization`:

```
Authorization: Bearer sk_live_your_api_key_here
```

Veja [Autenticação](/pt/authentication) para detalhes sobre criação e gerenciamento de chaves de API.

## Contexto do workspace

A maioria dos endpoints é vinculada a um workspace:

```
/api/workspace/{workspaceId}/...
```

Sua chave de API deve ter acesso ao workspace especificado.

## Formato da requisição

* **Content-Type**: `application/json` para todos os corpos de requisição
* **Accept**: `application/json` para todas as respostas
* **Upload de arquivos**: `multipart/form-data` para endpoints de importação

## Formato da resposta

Todas as respostas seguem uma estrutura JSON consistente. Respostas bem-sucedidas retornam o recurso diretamente. Erros retornam:

```json theme={null}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Title is required",
    "details": [
      {"field": "title", "message": "Must be at least 1 character"}
    ]
  }
}
```

## Grupos de endpoints

<CardGroup cols={3}>
  <Card title="Workspace" icon="building" href="/pt/api-reference/workspace/get-settings">
    Configurações, segurança, exportações, logs de auditoria
  </Card>

  <Card title="Membros" icon="users" href="/pt/api-reference/members/list-members">
    Convidar, gerenciar funções, remover membros
  </Card>

  <Card title="Marcas" icon="tag" href="/pt/api-reference/brands/list-brands">
    CRUD + especificações de IA
  </Card>

  <Card title="Catálogos" icon="folder-open" href="/pt/api-reference/catalogs/list-catalogs">
    Criar, publicar, bifurcar, mesclar
  </Card>

  <Card title="Produtos" icon="box" href="/pt/api-reference/products/list-products">
    CRUD + importação em lote
  </Card>

  <Card title="Serviços de IA" icon="sparkles" href="/pt/api-reference/ai/chat">
    Chat, gerar, aprimorar
  </Card>

  <Card title="Cobrança" icon="credit-card" href="/pt/api-reference/billing/get-billing">
    Assinaturas, faturas, uso
  </Card>

  <Card title="Chaves de API" icon="key" href="/pt/api-reference/api-keys/list-keys">
    Criar, listar, revogar
  </Card>

  <Card title="Integrações" icon="plug" href="/pt/api-reference/integrations/authorize">
    OAuth, sincronização, status
  </Card>
</CardGroup>