Arquitetura da API¶

Princípios REST¶

A API Pontotel segue os princípios REST (Representational State Transfer):

• Recursos: Entidades como usuários, empregados, escalas
• HTTP Methods: GET, POST, PUT, PATCH, DELETE
• JSON: Formato de dados para requisições e respostas
• Status Codes: Códigos HTTP padrão (200, 201, 400, 404, etc.)
• Stateless: Cada requisição é independente

Base URL¶

1

https://apis.pontotel.com.br/pontotel/api/v4/

1

https://sandbox-apis.pontotel.com.br/pontotel/api/v4/

HTTP Methods¶

Formato de Resposta Padrão¶

Listagem (GET collection)¶

Todas as respostas de listagem seguem o formato paginado:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
  "count": 150,
  "next": "https://apis.pontotel.com.br/pontotel/api/v4/usuarios/?page=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "username": "usuario1",
      "email": "usuario1@example.com"
    }
  ]
}

Objeto Individual (GET detail)¶

1
2
3
4
5
6
7
8

{
  "id": 1,
  "username": "usuario1",
  "email": "usuario1@example.com",
  "first_name": "João",
  "last_name": "Silva",
  "is_active": true
}

Erro¶

1
2
3
4
5
6
7

{
  "error": "validation_error",
  "message": "Dados inválidos na requisição",
  "details": {
    "email": ["Este campo é obrigatório."]
  }
}

Status Codes¶

Autenticação¶

Todas as requisições (exceto /login/) exigem o header:

1
2

Authorization: Bearer {seu_access_token}
Content-Type: application/json

Veja o guia completo em Autenticação →

Principais Domínios¶

Próximos Passos¶

• Conhecer os ambientes →
• Entender conceitos fundamentais →
• Começar a integração →