Arquitectura de la API¶

Principios REST¶

La API Pontotel sigue los principios REST (Representational State Transfer):

• Recursos: Entidades como usuarios, empleados, escalas
• **HTTP Methods**GET, POST, PUT, PATCH, DELETE
• JSO N: Formato de datos para consultas y respuestas
• Status Codes: Códigos HTTP estándar (200, 201, 400, 404, etc.)
• Stateless: Cada solicitud es independiente

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 respuesta estándar¶

Listado (GET collection)¶

Todas las respuestas de lista siguen el 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
}

Error¶

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¶

Autenticación¶

Todas las solicitudes (excepto /login/) exigen el header:

1
2

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

Vea la guía completa en Autenticación →

Principales dominios¶

Siguientes pasos¶

• Conocer los ambientes →
• Entender conceptos fundamentales →
• Comenzar integración →