API de Dados

1. Autenticação

Envie a chave no cabeçalho Authorization em toda requisição:

Authorization: Bearer SUA_CHAVE

Alternativa: X-API-Key: SUA_CHAVE. Sem chave válida → 401. Chave de leitura tentando gravar → 403.

2. Endpoints

GET /api/v1/tables

Lista as tabelas disponíveis, com colunas, contagem de linhas e se são graváveis.

curl -H "Authorization: Bearer SUA_CHAVE" \
  https://adv.omegalight.com.br/api/v1/tables

GET /api/v1/{tabela}

Lê os registros. Paginação: limit (padrão 100, máx. 1000) e offset. Filtro por igualdade em qualquer coluna: ?coluna=valor.

# página
curl -H "Authorization: Bearer SUA_CHAVE" \
  "https://adv.omegalight.com.br/api/v1/pedido_meta?limit=50&offset=0"

# com filtro
curl -H "Authorization: Bearer SUA_CHAVE" \
  "https://adv.omegalight.com.br/api/v1/pedido_meta?base=mega&numero=0726-000084"

Resposta: { "tabela", "total", "limit", "offset", "itens": [ ... ] }

POST /api/v1/{tabela} (chave de escrita)

Insere um registro. Corpo: objeto JSON com as colunas.

curl -X POST -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"base":"mega","numero":"0726-000084","resp_fechamento":"João"}' \
  https://adv.omegalight.com.br/api/v1/pedido_meta

PATCH /api/v1/{tabela} (chave de escrita)

Atualiza. Corpo com where (obrigatório) e set.

curl -X PATCH -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"where":{"base":"mega","numero":"0726-000084"},"set":{"resp_fechamento":"Maria"}}' \
  https://adv.omegalight.com.br/api/v1/pedido_meta

DELETE /api/v1/{tabela} (chave de escrita)

Apaga. Corpo com where obrigatório (nunca apaga a tabela inteira).

curl -X DELETE -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"where":{"base":"mega","numero":"0726-000084"}}' \
  https://adv.omegalight.com.br/api/v1/pedido_meta

3. Planilhas — LibreOffice Calc / Excel / Google Sheets

Ferramentas de planilha não enviam cabeçalho de autenticação. Para elas, a chave vai na URL (&key=SUA_CHAVE) e os dados saem em CSV ou tabela HTML com o parâmetro format.

LibreOffice Calc (atualização automática)

1. Menu Planilha ▸ Vincular a dados externos… (ou Sheet ▸ Link to External Data).
2. Cole a URL no formato HTML e aperte Enter dentro do campo da URL:
   

   https://adv.omegalight.com.br/api/v1/pedido_cache?format=html&limit=1000&key=SUA_CHAVE

3. Espere a caixa "Tabelas/intervalos disponíveis" encher e clique em HTML_1 (ou HTML_all). O botão OK só habilita depois de selecionar a tabela.
4. Marque "Atualizar a cada N segundos" se quiser atualização automática, e confirme.

https://adv.omegalight.com.br/api/v1/pedido_cache?format=csv&key=SUA_CHAVE

Alternativa em uma célula (texto único): =WEBSERVICE("...&format=csv&key=SUA_CHAVE").

Excel (Power Query)

Dados ▸ Obter Dados ▸ Da Web, cole a URL com format=csv&key=SUA_CHAVE.

Google Sheets

=IMPORTDATA("https://adv.omegalight.com.br/api/v1/pedido_cache?format=csv&key=SUA_CHAVE")

OnlyOffice

O OnlyOffice não tem "vincular a dados externos", WEBSERVICE nem IMPORTDATA, e as macros são bloqueadas de acessar a internet. Não dá para consultar a API ao vivo por ele. O caminho é baixar e abrir:

1. No navegador, abra a URL em CSV (ela baixa o arquivo):
   

   https://adv.omegalight.com.br/api/v1/pedido_cache?format=csv&key=SUA_CHAVE

2. Salve como .csv e abra no OnlyOffice — no diálogo de importação, escolha separador vírgula e codificação UTF-8.

No OnlyOffice não há atualização automática — rebaixe o CSV quando quiser os dados novos. Para atualização ao vivo, use LibreOffice, Excel ou Google Sheets.

4. Principais tabelas

Lista completa e colunas: GET /api/v1/tables. As mais usadas:

Módulo Comercial (Omega Active)

Funil de prospecção e cadência de vendas. Disponível pela mesma API de dados:

Exemplo — todo o funil em aberto: GET /api/v1/oa_oportunidade?status=Proposta&format=csv&key=SUA_CHAVE

5. Segurança e limites

• A API expõe apenas uma lista fechada de tabelas de negócio (as listadas acima). Tabelas de sistema, credenciais e o conteúdo de conversas de WhatsApp e e-mails não são acessíveis pela API.
• Segredos nunca são expostos: hashes de senha, credenciais WK/GED/e-mail, OTP, tokens e as chaves de API.
• users, audit_log, oa_intel e oa_config são somente leitura.
• PATCH e DELETE exigem where — não é possível alterar/apagar a tabela toda de uma vez.
• Toda ação por API é registrada na auditoria do sistema.
• Trate a chave como uma senha. Se vazar, um gestor revoga na hora em Configurações › API de dados.
• Use as chaves em servidor/integração — não as coloque em páginas/apps que rodam no navegador.