Referencia de API¶

Documentación Interactiva¶

Explore la documentación completa e interactiva de la API Puntotel utilizando nuestra interfaz Swagger UI.

Especificación OpenAPI¶

La especificación OpenAPI completa está disponible en:

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

Interfaz¶

Cómo usar Try It Out¶

1. Autentique primero¶

Antes de probar cualquier variable:

1. Vaya a la sección Authentication
2. Expanda la variable POST /login/
3. Haga clic en "Try it out"
4. Rellene con sus credenciales
5. Haga clic en "Execute"
6. Copie el access_token la respuesta

2. Autorice la interfaz¶

1. Haga clic en el botón "Authorize" la parte superior de la página (ícone de cadeado)
2. En el campo Value, cole el token en formato:

   Text Only
   1	Bearer tu_token_aqui

3. Haga clic en "Authorize"
4. Haga clic en "Close"

3. Prueba variable¶

Ahora puede probar cualquier variable:

1. Navega hasta la variable deseada
2. Haga clic en "Try it out"
3. Rellene los parámetros necesarios
4. Haga clic en "Execute"
5. Vea la respuesta completa a continuación

Navegación rápida por categoría¶

Autenticación¶

• POST /login/ - Realizar sesión y obtener token

Estructura organizacional¶

• GET /empregadores/ - Listar empleadores
• POST /empregadores/ - Crear empleador
• GET /locais-trabalho/ - Listar lugares
• GET /grupos/ - Listar grupos

Personas¶

• GET /usuarios/ - Listar usuarios
• POST /usuarios/ - Crear usuario
• GET /empregados/ - Listar empleados
• POST /empregados/ - Crear empleado

Jornada¶

• GET /escalas/ - Listar escalas
• POST /escalas/ - Crear escala
• GET /jornadas/ - Listar jornadas
• GET /marcacoes/ - Listar marcas
• POST /marcacoes/ - Registro marcado

Ausencias¶

• GET /ferias/ - Listar vacaciones
• POST /ferias/ - Registrar vacaciones
• GET /afastamentos/ - Listar alejadas
• POST /afastamentos/ - Registro de expulsión
• GET /justificativas/ - Listar justificaciones

Descarga de especificación¶

Puede descargar la especificación OpenAPI para uso en otras herramientas:

• 📥 Download JSON

Herramientas compatibles¶

• Postman - Colecciones y pruebas automatizadas
• Insomnia - Cliente REST
• Swagger Editor - Editor online
• OpenAPI Generator - Generación de SDK

Versiones API¶

Siguientes pasos¶

• Comenzar integración →
• Dominios de la API →
• Buenas Prácticas →