Pular para conteúdo

Portal de Integração Pontotel

Documentação oficial para desenvolvedores. Conecte sua empresa ao futuro da gestão de ponto.

O que você encontrará aqui

Esta documentação contém tudo o que você precisa para integrar seu sistema com as APIs da Pontotel de forma rápida e segura.

🚀 Getting Started

Comece em menos de 15 minutos com nosso guia de início rápido e exemplos práticos.

Começar agora →

📚 Entidades Pontotel

Documentação completa de todas as entidades: Usuários, Empregados, Escalas e mais.

Explorar entidades →

💡 Boas Práticas

Aprenda as melhores práticas de integração, segurança, performance e tratamento de erros.

Ver práticas →

🧪 Referência API

Documentação interativa completa com Swagger UI. Teste seus endpoints diretamente no navegador.

Explorar API →

Por que usar as APIs Pontotel?

  • ✅ RESTful: Arquitetura moderna baseada em JSON
  • ✅ Segura: Autenticação robusta via Bearer Token
  • ✅ Escalável: Projetada para grandes volumes de dados
  • ✅ OpenAPI: Especificação pública e interativa
  • ✅ Versionada: Garantia de estabilidade para seu código
  • ✅ Documentada: Guias claros e suporte dedicado

Início Rápido

Autentique-se e faça sua primeira requisição em 3 passos:

1. Obter Token de Acesso

Python
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
import requests

# Autenticação
login_url = "https://apis.pontotel.com.br/pontotel/api/v4/login/"
credentials = {
    "username": "seu_usuario",
    "password": "sua_senha"
}

response = requests.post(login_url, json=credentials)
token = response.json()["access_token"]

print(f"Token obtido: {token[:20]}...")
JavaScript
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
// Autenticação
const loginUrl = "https://apis.pontotel.com.br/pontotel/api/v4/login/";

const response = await fetch(loginUrl, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    username: 'seu_usuario',
    password: 'sua_senha'
  })
});

const { access_token } = await response.json();
console.log('Token obtido:', access_token.substring(0, 20) + '...');
Bash
1
2
3
4
5
6
curl -X POST "https://apis.pontotel.com.br/pontotel/api/v4/login/" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "seu_usuario",
    "password": "sua_senha"
  }'

2. Fazer Primeira Requisição

Python
1
2
3
4
5
6
7
8
# Listar usuários
headers = {"Authorization": f"Bearer {token}"}
users_url = "https://apis.pontotel.com.br/pontotel/api/v4/usuarios/"

response = requests.get(users_url, headers=headers)
users = response.json()

print(f"Total de usuários: {users['count']}")
JavaScript
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
// Listar usuários
const usersResponse = await fetch(
  'https://apis.pontotel.com.br/pontotel/api/v4/usuarios/',
  {
    headers: { 'Authorization': `Bearer ${access_token}` }
  }
);

const users = await usersResponse.json();
console.log('Total de usuários:', users.count);
Bash
1
2
curl -X GET "https://apis.pontotel.com.br/pontotel/api/v4/usuarios/" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"

3. Explorar Mais

Agora que você fez sua primeira requisição:

Pronto para começar?

Siga nosso guia passo a passo e integre em menos de 15 minutos.

Começar Agora →

Suporte e Changelog

Suporte e Comunidade

  • 💬 FAQ: Confira nosso FAQ
  • 📧 E-mail: suporte@pontotel.com.br

Status da API

v4.0.0
Última atualização: Fevereiro 2026