# Claritio

> Sistema de RH brasileiro: controle de ponto, ocorrências, banco de horas,
> férias, admissão e portal do colaborador. A API de integração permite ler
> colaboradores, batidas, ocorrências e espelho de ponto, e lançar batidas
> vindas de outro relógio ou sistema.

A API é HTTP+JSON, autenticada por chave no cabeçalho
`Authorization: Bearer <chave>`. Base: https://rh.claritio.com.br/api/publica/v1

Há um simulador público que responde dados de exemplo sem cadastro nem chave
real, útil para testar antes de integrar:
`curl -H "Authorization: Bearer clr_demo_0000000000000000000000000000" https://rh.claritio.com.br/api/publica/v1/ping`

## Documentação

- [Visão geral](https://docs.claritio.com.br/#visao-geral): A API do Claritio deixa o seu sistema ler e lançar dados de RH: quem trabalha na empresa, o ponto que essas pessoas bate…
- [Começar em 3 minutos](https://docs.claritio.com.br/#comecar): Não precisa de cadastro, nem de chave, nem de falar com ninguém para ver a API funcionando. Escolha a sua linguagem e co…
- [Autenticação](https://docs.claritio.com.br/#autenticacao): Toda chamada leva a chave num cabeçalho: Se for mais fácil no seu cliente, X Api Key: clr_... funciona igual. Como a emp…
- [Escopos](https://docs.claritio.com.br/#escopos): Cada chave carrega só o que precisa. Quem cria escolhe: Escopo O que libera pessoas:ler Lista de colaboradores, com CPF …
- [Erros](https://docs.claritio.com.br/#erros): Resposta boa é sempre assim: Erro é assim: Código O que houve 400 Falta um parâmetro, ou ele veio num formato que não dá…
- [Limites](https://docs.claritio.com.br/#limites): São dois tetos, e eles protegem coisas diferentes. Teto Padrão O que ele protege Por minuto 120 O servidor, de picos Por…
- [Segurança](https://docs.claritio.com.br/#seguranca): A chave é do seu servidor. Não a coloque no aplicativo, no repositório nem em código que roda no navegador de alguém. Qu…
- [Datas, fusos e páginas](https://docs.claritio.com.br/#formatos): Datas são AAAA MM DD . Horários vão e voltam em ISO 8601 com fuso: 2026 09 26T08:03:00 03:00 . O dia de uma batida é o d…
- [Simulador](https://docs.claritio.com.br/#simulador): A chave abaixo é pública e pode ficar no seu README: Com ela, todas as rotas respondem dados de exemplo de uma padaria q…
- [GET /ping](https://docs.claritio.com.br/#ping): Diz se a chave funciona, de que empresa ela é e o que ela pode fazer. É a primeira chamada de quem está configurando — e…
- [GET /colaboradores](https://docs.claritio.com.br/#colaboradores): Quem trabalha na empresa. Parâmetro Padrão O que faz situacao ativos ativos , desligados ou todos desde — Só quem mudou …
- [POST /colaboradores](https://docs.claritio.com.br/#colaboradores-criar): Cadastra uma pessoa. Nome e CPF são o mínimo — o resto é opcional. Campo Obrigatório Observação nome sim cpf sim Com ou …
- [POST /colaboradores/atualizar](https://docs.claritio.com.br/#colaboradores-editar): Corrige o cadastro, ou desliga. colaborador aceita o id ou a matrícula. Campo que não vem não é tocado ; mandar null apa…
- [GET /batidas](https://docs.claritio.com.br/#batidas-ler): As batidas de um período. A batida sai inteira : hora, lugar, aparelho, se foi negada, se alguém mexeu nela e o que ela …
- [POST /batidas](https://docs.claritio.com.br/#batidas-escrever): Lança batidas vindas de outro relógio ou sistema. Até 200 por chamada . colaborador aceita a matrícula ou o id — use a m…
- [GET /ocorrencias](https://docs.claritio.com.br/#ocorrencias): Faltas, atrasos e atestados do período, com o que cada um mexeu no banco de horas. Parâmetro Obrigatório O que faz de / …
- [GET /espelho](https://docs.claritio.com.br/#espelho): O espelho de ponto de uma pessoa num mês: cada dia com as batidas e o que entrou ou saiu do banco de horas. Parâmetro Ob…
- [Receitas](https://docs.claritio.com.br/#receitas): Sincronizar o cadastro toda noite Mandar as batidas do relógio, em lote Fechar o mês de uma pessoa…
- [Perguntas frequentes](https://docs.claritio.com.br/#perguntas): Preciso do id do Claritio? Não. Onde cabe um colaborador, cabe a matrícula que você já usa. A chave vence? Não. Ela vale…
- [Mudanças](https://docs.claritio.com.br/#mudancas): Dentro do /v1 , prometemos: não remover campo nem rota; não mudar o tipo nem o significado de um campo existente; poder …

## Tudo em um arquivo

- [Documentação completa em Markdown](https://docs.claritio.com.br/api.md)

## Contato

- E-mail: claritio@claritio.com.br
- Site: https://claritio.com.br