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

# Primeiros passos

> Da API Key à primeira listagem de produtos.

Faça isto no **servidor** da integração. A chave não vai para o frontend da loja.

<Steps>
  <Step title="Crie uma API Key">
    No painel Corvex, abra **API Keys** e crie uma chave com:

    * os escopos da integração (`products:read`, `orders:read`, etc.)
    * ao menos uma loja em **lojas permitidas**

    O valor `cvx_live_...` aparece **uma vez**. Guarde em um secret manager.
  </Step>

  <Step title="Envie o ID da loja">
    O UUID da loja vai no header, em toda requisição:

    ```http theme={null}
    X-Store-Id: 11111111-1111-4111-8111-111111111111
    ```

    A chave só funciona nas lojas autorizadas na criação.
  </Step>

  <Step title="Liste os produtos">
    ```bash theme={null}
    curl "https://apiv3.usecorvex.com.br/api/v1/products?page=1&limit=20" \
      -H "Authorization: Bearer cvx_live_YOUR_API_KEY" \
      -H "X-Store-Id: 11111111-1111-4111-8111-111111111111"
    ```

    Sucesso: `200` com `success: true`, `data.products` e `data.pagination`.
  </Step>
</Steps>

<Tip>
  Use `Authorization: Bearer cvx_live_...`. Não use `x-api-key` — essa credencial é do checkout externo.
</Tip>

## Próximo passo

Crie um produto físico com `POST` e o mesmo `X-Store-Id`. Produtos `PHYSICAL` exigem `logistics`.

Se receber `401` ou `403`, veja [Autenticação](/authentication).