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

# Introdução

> Documentação oficial da API REST do OmniDom Hub Marketplace

<Note>
  Esta é a referência viva (Swagger) de todos os endpoints REST do backend OmniDom.
  Ela é útil caso você queira integrar um sistema externo, ERP secundário ou construir painéis customizados.
</Note>

Bem-vindo à API do OmniDom. Nossa API segue as melhores práticas de design RESTful e retorna respostas em formato JSON previsível, incluindo padronização rigorosa de códigos de erro HTTP globais.

## Base URL

A URL base para testes locais e produção depende do seu ambiente de implantação. Em deploy na Vercel/Railway, certifique-se de apontar para o domínio correto fornecido.

```bash HTTP theme={null}
http://localhost:3001
```

## Autenticação (Bearer JWT)

Todos os endpoints marcados com um cadeado requerem que você envie um cabeçalho `Authorization` contendo um JTW (JSON Web Token) válido obtido na rota de Login (`POST /auth/login`).

```bash theme={null}
Authorization: Bearer <seu_token_jwt_aqui>
```

<Card title="Guia Prático de Auth" icon="shield" href="/omnidom/tutorial-auth">
  Leia o manual passo-a-passo explicando como obter e renovar Tokens.
</Card>