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

# Primeiros passos

> Gerencie sua loja, filiais e produtos no Jelou Shop via API REST.

Com a API do Jelou Shop você pode gerenciar filiais e criar ou atualizar produtos programaticamente, caso não use um e-commerce externo como fonte de dados.

## Autenticação

Para consumir os endpoints você precisa de:

| Credencial | Descrição |
| - | - |
| `app_id` | O ID da sua loja no Jelou Shop |
| Chave de API | Chave de API para autenticar as requisições ao gateway de ecommerce |

> [!NOTE]
>
> Encontre o `app_id` (Shop ID) em [Shop Admin → Configuração](https://docs.jelou.ai/pt/guias/integracoes/e-commerce/shop-admin.md#configuração) ou diretamente em [Configuração](https://apps.jelou.ai/shop-v2/settings).
>
> Gere e administre sua chave de API no módulo de [Chaves de API](https://docs.jelou.ai/pt/guias/configuracao/chaves-api.md).

Inclua a chave de API no header `x-api-key` de cada requisição:

```bash theme={null}
x-api-key: YOUR_API_KEY
```

## URL base

Use a seguinte URL base para todos os endpoints:

```
https://gateway.jelou.ai/ecommerce
```

## Recursos disponíveis

> [card] [Filiais](https://docs.jelou.ai/pt/api/shop/filiais/criar.md)
>
> Crie e gerencie filiais para organizar seus produtos por localização.

> [card] [Produtos](https://docs.jelou.ai/pt/api/shop/produtos/listar.md)
>
> Crie ou atualize produtos com variações e atribuição de filial.

> [card] [Promoções](https://docs.jelou.ai/pt/api/shop/cupons/criar.md)
>
> Crie cupons de desconto por porcentagem ou valor fixo, com vigência e escopo por filial.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.