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](faq/index.md) - 📧 **E-mail**: suporte@pontotel.com.br
#### Status da API v4.0.0
Última atualização: Fevereiro 2026