Ambientes
A API Owem opera atualmente apenas em ambiente de produção.
| Ambiente | URL Base | Status |
|---|
| Produção | https://api.owem.com.br | ✅ Disponível |
| Sandbox | - | 🚧 Em breve |
Atualmente não existe ambiente de sandbox separado. As operações são realizadas
diretamente no ambiente de produção.
Variáveis de Ambiente
Recomendamos configurar as seguintes variáveis no seu ambiente:
Variáveis Obrigatórias
| Variável | Descrição |
|---|
OWEM_API_KEY | API Key da sua credencial |
OWEM_API_SECRET | API Secret (nunca exponha) |
OWEM_ACCOUNT_ID | ID da sua conta bancária Owem |
Variáveis Opcionais
| Variável | Descrição | Padrão |
|---|
OWEM_BASE_URL | URL base da API | https://api.owem.com.br |
OWEM_TIMEOUT | Timeout em ms | 30000 |
OWEM_WEBHOOK_SECRET | Secret para validar webhooks | - |
Exemplo de Configuração
# Credenciais Owem
OWEM_API_KEY=912fea22-5b3f-4e6c-8dfc-8e4b72a5c469
OWEM_API_SECRET=ae35c77f78b8f3874550bb249ed986b9...
OWEM_ACCOUNT_ID=982345671234
# Configurações
OWEM_BASE_URL=https://api.owem.com.br
OWEM_TIMEOUT=30000
ENV OWEM_API_KEY=912fea22-5b3f-4e6c-8dfc-8e4b72a5c469
ENV OWEM_API_SECRET=ae35c77f78b8f3874550bb249ed986b9...
ENV OWEM_ACCOUNT_ID=982345671234
ENV OWEM_BASE_URL=https://api.owem.com.br
apiVersion: v1
kind: Secret
metadata:
name: owem-credentials
type: Opaque
stringData:
OWEM_API_KEY: 912fea22-5b3f-4e6c-8dfc-8e4b72a5c469
OWEM_API_SECRET: ae35c77f78b8f3874550bb249ed986b9...
OWEM_ACCOUNT_ID: 982345671234
| Header | Valor | Descrição |
|---|
Authorization | Basic {token} | Token Base64 de autenticação |
Content-Type | application/json | Tipo de conteúdo |
| Header | Valor | Descrição |
|---|
X-Idempotency-Key | UUID | Chave de idempotência |
X-Request-Id | UUID | ID de rastreio customizado |
A API retorna headers úteis para monitoramento:
| Header | Descrição |
|---|
X-RateLimit-Limit | Limite de requisições por período |
X-RateLimit-Remaining | Requisições restantes |
X-RateLimit-Reset | Timestamp de reset (epoch) |
X-Request-Id | ID único da requisição |
Use o X-Request-Id ao abrir tickets de suporte para agilizar a investigação.
Timeouts Recomendados
| Operação | Timeout Sugerido |
|---|
| Ping / Health check | 5s |
| Consultas (GET) | 15s |
| Geração de QR Code | 30s |
| Transferências PIX | 60s |
| Webhooks (resposta) | 3s |
Webhooks que não respondem em 3 segundos são considerados falhos e entram
em retry.
