Superfície de integração curada para sistemas externos que gravam dados na plataforma. Lista operações de escrita (e a autenticação necessária) em V1 e V2 quando ambas existem.

Autenticação e autorização

Estrutura de URLs por Tenant

Nossa API segue um modelo multi-tenant baseado em schemas. Isso significa que cada cliente (tenant) possui seu próprio schema no banco de dados, isolando completamente seus dados.

Subdomínio por tenant

Cada tenant possui um subdomínio exclusivo, que é usado tanto para o sistema quanto para a API.

Sistema (interface do cliente):
https://verticeponto.verticeponto.com.br
API (integração com sistemas externos):
https://verticeponto.api.3pontoapp.com.br

Importante: o subdomínio verticeponto representa o nome do tenant e está diretamente ligado ao schema no banco de dados.

Solicitação de token de acesso

Seu aplicativo envia o código de autorização, juntamente com as credenciais do aplicativo, para o 3Ponto APP para solicitar um token de acesso.

curl -X POST https://verticeponto.api.3pontoapp.com.br/accounts/login/ \ --header "Content-Type: application/json" \ --header "Accept: */*" \ --data '{"username": "string", "password": "string"}'

Utilização do token de acesso

Finalmente, seu aplicativo pode usar o token de acesso para fazer solicitações à API em nome do usuário.

Authorization: JWT {token}

## Host por tenant Cada cliente responde em `https://{tenant}.api.3pontoapp.com.br`, onde `{tenant}` é o subdomínio (schema) do cliente. ## Documentação completa A API completa (V1 e V2) está documentada em https://api.3pontoapp.com.br/docs.

201Marcações criadas com sucesso.

400Erros de validação (justificativa/período/colaborador obrigatórios, período fechado, marcações sem par Entrada/Saída).