Onli Ponto API e integração para agentes

A API pública permite consultar informações comerciais do Onli Ponto por HTTP. Ela é somente leitura, não exige autenticação e não recebe nem consulta dados de empresas, colaboradores ou registros de ponto.

Acesso e formato

Todas as operações usam GET e respondem em JSON UTF-8. Não envie credenciais, nomes, e-mails, CNPJ de clientes ou qualquer dado de jornada. O CORS permite chamadas de leitura de qualquer origem; as respostas podem ser armazenadas por até 60 segundos no navegador e 5 minutos no cache compartilhado.

Consulte também o OpenAPI 3.1 em JSON, o alias YAML e o catálogo de APIs.

Endpoints

`GET /api/v1/plans`

Retorna os planos públicos, faixas de colaboradores, preços mensais e faixas de preço por volume. Para equipes acima de 20 pessoas, o preço mínimo mensal atual é R$ 89,90.

`GET /api/v1/quote?employees=N`

Calcula o preço mensal para um número inteiro de 1 a 1.000 colaboradores usando a mesma regra de preço do site e do diagnóstico. Outros parâmetros, valores fracionários e quantidades fora desse intervalo retornam 400.

`GET /api/v1/health`

Retorna {"status":"ok"}.

Exemplos com curl

curl -i https://onliponto.com.br/api/v1/plans

curl -i "https://onliponto.com.br/api/v1/quote?employees=25"

curl -i https://onliponto.com.br/api/v1/health

Erros

As rotas inexistentes retornam 404, os parâmetros inválidos retornam 400 e métodos diferentes de GET retornam 405. Os erros usam application/json e este formato:

{"error":{"code":"invalid_parameter","message":"Os parâmetros informados são inválidos.","hint":"Informe employees como um único número inteiro entre 1 e 1000.","docs":"https://onliponto.com.br/docs"}}

Limites e versionamento

A cotação aceita de 1 a 1.000 colaboradores por solicitação. A API não oferece operações de escrita, integração com contas ou acesso a dados de clientes. O prefixo /api/v1 identifica esta versão; mudanças incompatíveis serão publicadas em outro prefixo. As faixas e preços acompanham a tabela pública do produto e podem mudar quando os preços do site mudarem.

Para dúvidas sobre a API, escreva para contato@onliponto.com.br.