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

# Conceitos essenciais

> Os conceitos que você precisa entender antes de integrar: idEmail, processamento assíncrono, prefixo /gw/ e fuso horário.

Antes de começar a integrar, vale entender alguns conceitos que aparecem em toda a API da AR Online.

## idEmail: o identificador de rastreio

Todo envio bem-sucedido retorna um `idEmail` — um identificador único (UUID) gerado pela plataforma:

```json theme={null}
{
  "idEmail": "8c4813f5-8430-4ad4-ab72-19d7eed39731"
}
```

Esse é o **identificador de rastreio** do envio. Guarde-o: é com ele que você consulta o status de cada canal (e-mail, SMS, WhatsApp, voz e carta), obtém comprovantes e laudos.

<Tip>
  Você também pode informar um `customID` no envio — uma referência externa sua (por exemplo, o ID do registro no seu sistema) para correlacionar com seus próprios registros.
</Tip>

## HTTP 200 significa "aceito", não "entregue"

O envio é **assíncrono**. Quando a API responde `HTTP 200` com o `idEmail`, isso significa que a requisição foi **aceita para processamento** — e não que a mensagem já foi entregue.

<Warning>
  **`HTTP 200` não é confirmação de entrega.** A entrega acontece em segundo plano, após a resposta. Para saber se a mensagem foi efetivamente enviada, entregue ou lida, você precisa [consultar o status](/acompanhando/consultar-status) ou receber as atualizações via [webhook](/webhooks/visao-geral).
</Warning>

## O prefixo público /gw/

Os endpoints públicos da API usam o prefixo `/gw/`. A base é:

```
https://api.ar-online.com.br
```

Assim, o envio é feito em `POST https://api.ar-online.com.br/gw/email`, a consulta de status do e-mail em `GET /gw/email/{idEmail}`, e assim por diante.

<Info>
  Há uma exceção: o endpoint de finalização de régua de notificação **não** usa o prefixo `/gw/` (`GET /regua-notificacao/finalizar/{idEmail}`).
</Info>

## Datas no fuso de Brasília (BRT)

Todas as datas retornadas pela API estão no fuso horário **BRT (horário de Brasília)**. Considere isso ao exibir ou comparar timestamps na sua aplicação.