Inicio

APIs Última actualización: Febrero de 2025

Bienvenido a la documentación oficial de las APIs de RSM App. Aquí encontrarás toda la información necesaria para integrarte fácilmente con nuestros servicios. Nuestra suite de APIs proporciona acceso seguro y eficiente a datos críticos, permitiéndote consultar y gestionar la información esencial de tu organización.

💡 ¿Qué es una API?

Una API (Application Programming Interface) es un conjunto de reglas y protocolos que permite a diferentes sistemas comunicarse entre sí. Con nuestras APIs, podrás interactuar con el sistema RSM desde tus propias aplicaciones, automatizando procesos y mejorando la eficiencia.

🚀 Características Principales:
  • RESTful: Nuestras APIs siguen el estándar REST, usando métodos HTTP como GET, POST, PUT, y DELETE.
  • Seguridad: Autenticación mediante X-Auth-Token con claves únicas para cada desarrollador.
  • Formato: Las respuestas son en formato JSON, facilitando la integración y el procesamiento de datos.
  • Control de Errores: Sistema detallado de códigos de estado HTTP y mensajes de error.
  • Registro de Actividades: Cada consulta queda registrada para auditoría y control.
🛡️ Seguridad y Autenticación:

Para acceder a cualquier API, es necesario incluir tu API Key en el encabezado (X-Auth-Token). Asegúrate de mantener tu clave segura y no compartirla públicamente.

📌 URL Base de las APIs:
https://tiemposrsm.com/API/v2/{nombreapi}
✅ Ejemplo de Encabezado (Header):
{
  "X-Auth-Token": "Bearer TU_API_KEY"
}
📘 Ejemplo de Consumo con Python:
import requests

url = "https://tiemposrsm.com/API/v2/users"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())
🚨 Manejo de Errores:

Nuestras APIs devuelven códigos HTTP estándar. A continuación se listan los más comunes:

  • 200 OK – Solicitud exitosa.
  • 400 Bad Request – Error en la solicitud (parámetros inválidos).
  • 401 Unauthorized – Falta o es inválida la API Key.
  • 403 Forbidden – API Key sin permisos o expirada.
  • 404 Not Found – Recurso no encontrado.
  • 500 Internal Server Error – Error en el servidor.

Usuarios Última actualización: 18 de Febrero 2025

Esta API proporciona una lista de todos los usuarios registrados en el sistema según la compañía asociada a la API Key.

Descripción

Obtener la lista de usuarios según el idCia relacionado con la API Key.

Solicitud (Request)

📌 URL del Endpoint
https://tiemposrsm.com/API/v2/users
✅ Método
  • Método: GET
  • Formato: application/json
  • Autenticación: Requiere API Key mediante X-Auth-Token Header.
🔑 Headers Requeridos
{
  "X-Auth-Token": "Bearer {api_key}"
}
📘 Ejemplo de Consumo con Python:
import requests

url = "https://tiemposrsm.com/API/v2/users"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)

print(response.json())

Respuesta (Response)

✅ Ejemplo de Respuesta Exitosa (200):
{
  "status": "success",
  "total": 2,
  "data": [
    {
      "idEmpleado": 101,
      "name": "Juan Pérez",
      "login": "jperez",
      "email": "[email protected]",
      "Puesto": "Gerente",
      "Activo": 1
    },
    {
      "idEmpleado": 102,
      "name": "Ana López",
      "login": "alopez",
      "email": "[email protected]",
      "Puesto": "Consultor",
      "Activo": 1
    }
  ]
}
⚠️ Ejemplos de Errores:
401 - No Autorizado
{
  "error": "No autorizado: Falta API Key"
}
403 - API Key Expirada
{
  "error": "API Key expirada"
}
500 - Error Interno del Servidor
{
  "error": "Error en la base de datos"
}

Códigos de Estado

Código Significado
200 Solicitud exitosa
400 Solicitud incorrecta
401 Falta o es inválida la API Key
403 API Key expirada o sin permisos
500 Error interno del servidor

Notas Importantes

Recomendaciones

  • Utilizar HTTPS para todas las solicitudes.
  • La API Key es confidencial. Evitar exponerla en clientes públicos.
  • Se recomienda implementar control de límite de solicitudes (rate limiting).

Indicadores de Proyecto Última actualización: Febrero de 2025

La API `indicadorproyecto` proporciona información detallada sobre un proyecto específico, incluyendo métricas clave como horas planeadas, horas consumidas, costos y facturación acumulada. Esta API es útil para realizar análisis de desempeño y seguimiento de proyectos.

🛡️ Requisitos de Autenticación:

Para consumir esta API, es necesario incluir la clave de API (`X-Auth-Token`) en los encabezados.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/indicadorproyecto

📝 Parámetros de Consulta

Parámetro Tipo Descripción Obligatorio
X-Auth-Token Header Clave de autenticación del desarrollador ✅ Sí
proyecto Query Código del proyecto a consultar ✅ Sí

📥 Ejemplo de Solicitud (Request)

Consulta el indicador de un proyecto usando Python:

import requests

url = "https://tiemposrsm.com/API/v2/indicadorproyecto"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}
params = {
    "proyecto": "PROY2025AA04"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

Si la solicitud es correcta, se recibe una respuesta en formato JSON:

{
  "nombreProyecto": "PROY2025AA04",
  "horasPlaneadas": 500,
  "honorarios": 150000,
  "horasConsumidas": 350,
  "costoConsumido": 105000,
  "facturadoAcumulado": 120000,
  "mesesTranscurridos": 8
}

🚨 Posibles Errores

La API proporciona mensajes de error claros en caso de fallo. A continuación se listan los más comunes:

Código Descripción Ejemplo
400 Bad Request Faltan parámetros obligatorios {"error":"Falta el parámetro 'proyecto'"}
401 Unauthorized API Key inválida o ausente {"error":"No autorizado: Falta API Key"}
404 Not Found Proyecto no encontrado {"error":"Proyecto no encontrado"}
500 Internal Server Error Error interno en el servidor {"error":"Error en la base de datos"}

💡 Notas y Recomendaciones

  • Frecuencia: Esta API se actualiza en tiempo real. Se recomienda realizar consultas periódicas, pero evitar exceder los límites de uso.
  • Seguridad: No compartas tu X-Auth-Token públicamente. Almacénala de forma segura.

Clientes Última actualización: Febrero de 2025

La API `clientes` proporciona información sobre los clientes registrados en el sistema. Esta API es fundamental para la gestión de relaciones comerciales y seguimiento de clientes.

🛡️ Requisitos de Autenticación:

Esta API requiere incluir la clave de API (X-Auth-Token) en los encabezados para su uso.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/clientes

📝 Parámetros de Consulta

Parámetro Tipo Descripción Obligatorio
X-Auth-Token Header Clave de autenticación del desarrollador ✅ Sí

📥 Ejemplo de Solicitud (Request)

Consulta la lista de clientes usando Python:

import requests

url = "https://tiemposrsm.com/API/v2/clientes"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

Si la solicitud es correcta, se recibe una respuesta en formato JSON:

{
  "status": "success",
  "total": 2,
  "data": [
    {
      "idCliente": 12345,
      "nombre": "Cliente Ejemplo 1",
      "rfc": "ABC123456789",
      "correo": "[email protected]",
      "telefono": "9991234567"
    },
    {
      "idCliente": 67890,
      "nombre": "Cliente Ejemplo 2",
      "rfc": "XYZ987654321",
      "correo": "[email protected]",
      "telefono": "9997654321"
    }
  ]
}

🚨 Posibles Errores

La API proporciona mensajes de error claros en caso de fallo. A continuación se listan los más comunes:

Código Descripción Ejemplo
400 Bad Request Faltan parámetros obligatorios o malformados {"error":"Parámetros inválidos"}
401 Unauthorized API Key inválida o ausente {"error":"No autorizado: Falta API Key"}
404 Not Found Cliente no encontrado {"error":"Cliente no encontrado"}
500 Internal Server Error Error interno en el servidor {"error":"Error en la base de datos"}

💡 Notas y Recomendaciones

  • Frecuencia: Esta API se actualiza en tiempo real. Se recomienda realizar consultas periódicas, pero evitando exceder los límites de uso.
  • Seguridad: Mantén segura tu clave X-Auth-Token. No la expongas en código público.

Hoja de Trabajo Última actualización: Febrero de 2025

La API `hojatrabajo` permite consultar y gestionar las horas trabajadas registradas en el sistema por proyecto y empleado. Esta API es clave para el control de tiempos y costos.

🛡️ Requisitos de Autenticación:

Esta API requiere incluir la clave de API (X-Auth-Token) en los encabezados para su uso.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/hojatrabajo

📝 Parámetros de Consulta

Parámetro Tipo Descripción Obligatorio
X-Auth-Token Header Clave de autenticación del desarrollador ✅ Sí

📥 Ejemplo de Solicitud (Request)

Consulta las horas trabajadas usando Python:

import requests

url = "https://tiemposrsm.com/API/v2/hojatrabajo"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

Si la solicitud es correcta, se recibe una respuesta en formato JSON:

{
  "status": "success",
  "total": 2,
  "data": [
    {
      "idEmpleado": 101,
      "idProy": 2102,
      "fecha": "2024-01-05",
      "hora": 8.5,
      "actividad": "Revisión de informes",
      "costoHora": 500.00,
      "totalCosto": 4250.00
    },
    {
      "idEmpleado": 101,
      "idProy": 2102,
      "fecha": "2024-01-10",
      "hora": 7.0,
      "actividad": "Reunión con cliente",
      "costoHora": 500.00,
      "totalCosto": 3500.00
    }
  ]
}

🚨 Posibles Errores

La API proporciona mensajes de error claros en caso de fallo. A continuación se listan los más comunes:

Código Descripción Ejemplo
400 Bad Request Faltan parámetros obligatorios o malformados {"error":"Parámetros inválidos"}
401 Unauthorized API Key inválida o ausente {"error":"No autorizado: Falta API Key"}
404 Not Found No se encontraron registros {"error":"No se encontraron registros"}
500 Internal Server Error Error interno en el servidor {"error":"Error en la base de datos"}

💡 Notas y Recomendaciones

  • Frecuencia: La API se actualiza en tiempo real. Consulta regularmente, pero respeta los límites de uso.
  • Seguridad: Protege tu clave X-Auth-Token. No la compartas ni expongas en código público.

Hoja de Trabajo Meta Última actualización: Febrero de 2025

La API `hojaTrabajoMeta` permite consultar las metas de horas trabajadas definidas para los empleados. Este endpoint es útil para monitorear el cumplimiento de metas y objetivos por periodo.

🛡️ Requisitos de Autenticación:

Esta API requiere incluir la clave de API (X-Auth-Token) en los encabezados para su uso.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/hojaTrabajoMeta

📝 Parámetros de Consulta

Parámetro Tipo Descripción Obligatorio
X-Auth-Token Header Clave de autenticación del desarrollador ✅ Sí

📥 Ejemplo de Solicitud (Request)

Consulta las metas de horas trabajadas usando Python:

import requests

url = "https://tiemposrsm.com/API/v2/hojaTrabajoMeta"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

Si la solicitud es correcta, se recibe una respuesta en formato JSON:

{
  "status": "success",
  "total": 2,
  "data": [
    {
	"idEmpleado": 100147,
        "name": "PETER ALEJANDRO PEREZ CHEL",
        "idCia": 2102,
        "Activo": 1,
        "Puesto": "Encargado 2",
        "HorasTotalesMensual": "191.00",
        "Cargables": "87.00",
        "Fecha": "2025-01-01",
        "MetaHoras": 8
    },
  ]
}

🚨 Posibles Errores

La API proporciona mensajes de error claros en caso de fallo. A continuación se listan los más comunes:

Código Descripción Ejemplo
400 Bad Request Faltan parámetros obligatorios o malformados {"error":"Parámetros inválidos"}
401 Unauthorized API Key inválida o ausente {"error":"No autorizado: Falta API Key"}
404 Not Found No se encontraron registros {"error":"No se encontraron metas"}
500 Internal Server Error Error interno en el servidor {"error":"Error en la base de datos"}

💡 Notas y Recomendaciones

  • Frecuencia: La API se actualiza en tiempo real. Se recomienda consultar de manera mensual para el seguimiento de metas.
  • Seguridad: Asegúrate de proteger tu clave X-Auth-Token.

Actividades Última actualización: Febrero de 2025

La API `actividades` permite obtener el listado de actividades registradas en el sistema. Es útil para consultar las tareas, procesos o acciones relacionadas con los proyectos o empleados.

🛡️ Requisitos de Autenticación:

Esta API requiere incluir la clave de API (X-Auth-Token) en los encabezados para su uso.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/actividades

📝 Parámetros de Consulta

Parámetro Tipo Descripción Obligatorio
X-Auth-Token Header Clave de autenticación del desarrollador ✅ Sí

📥 Ejemplo de Solicitud (Request)

Consulta las actividades registradas usando Python:

import requests

url = "https://tiemposrsm.com/API/v2/actividades"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

📤 Ejemplo de Respuesta (Response)

Si la solicitud es correcta, se recibe una respuesta en formato JSON:

{
  "status": "success",
  "total": 3,
  "data": [
    {
      "idActividad": 105,
      "idProy": 3105,
      "nombre": "Revisión de informes",
      "descripcion": "Revisión y validación de informes mensuales",
      "responsable": "Carlos Martínez",
      "fechaInicio": "2024-02-05",
      "fechaFin": "2024-02-10",
      "estado": "Completada"
    },
    {
      "idActividad": 106,
      "idProy": 3105,
      "nombre": "Auditoría interna",
      "descripcion": "Revisión de cumplimiento de procesos",
      "responsable": "Ana López",
      "fechaInicio": "2024-03-01",
      "fechaFin": "2024-03-15",
      "estado": "En proceso"
    },
    {
      "idActividad": 107,
      "idProy": 3105,
      "nombre": "Capacitación",
      "descripcion": "Capacitación al equipo de trabajo",
      "responsable": "Pedro Pérez",
      "fechaInicio": "2024-04-10",
      "fechaFin": "2024-04-12",
      "estado": "Pendiente"
    }
  ]
}

🚨 Posibles Errores

La API proporciona mensajes de error claros en caso de fallo. A continuación se listan los más comunes:

Código Descripción Ejemplo
400 Bad Request Faltan parámetros obligatorios o malformados {"error":"Parámetros inválidos"}
401 Unauthorized API Key inválida o ausente {"error":"No autorizado: Falta API Key"}
404 Not Found No se encontraron registros {"error":"No se encontraron actividades"}
500 Internal Server Error Error interno en el servidor {"error":"Error en la base de datos"}

💡 Notas y Recomendaciones

  • Frecuencia: Se recomienda consultar diariamente si se usa para monitoreo de actividades.
  • Seguridad: Mantén tu X-Auth-Token seguro y confidencial.

Departamentos Última actualización: Febrero de 2025

La API `deptos` permite obtener el listado de departamentos registrados en el sistema. Es útil para gestionar y consultar la estructura organizativa de la compañía.

🛡️ Requisitos de Autenticación:

Esta API requiere incluir la clave de API (X-Auth-Token) en los encabezados para su uso.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/deptos

📝 Parámetros de Consulta

Parámetro Tipo Descripción Obligatorio
X-Auth-Token Header Clave de autenticación del desarrollador ✅ Sí

📥 Ejemplo de Solicitud (Request)

Consulta el listado de departamentos usando Python:

import requests

url = "https://tiemposrsm.com/API/v2/deptos"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

Si la solicitud es correcta, se recibe una respuesta en formato JSON:

{
  "status": "success",
  "total": 3,
  "data": [
    {
      "idDepto": 101,
      "nombre": "Recursos Humanos",
      "descripcion": "Departamento de gestión de personal",
      "activo": 1
    },
    {
      "idDepto": 102,
      "nombre": "Contabilidad",
      "descripcion": "Departamento de finanzas y contabilidad",
      "activo": 1
    },
    {
      "idDepto": 103,
      "nombre": "Tecnología",
      "descripcion": "Departamento de tecnología y sistemas",
      "activo": 1
    }
  ]
}

🚨 Posibles Errores

La API proporciona mensajes de error claros en caso de fallo. A continuación se listan los más comunes:

Código Descripción Ejemplo
400 Bad Request Parámetros inválidos o malformados {"error":"Parámetros inválidos"}
401 Unauthorized API Key inválida o ausente {"error":"No autorizado: Falta API Key"}
404 Not Found No se encontraron departamentos {"error":"No se encontraron departamentos"}
500 Internal Server Error Error interno en el servidor {"error":"Error en la base de datos"}

💡 Notas y Recomendaciones

  • Frecuencia: Se recomienda consultar semanalmente si es para actualizaciones de estructura organizativa.
  • Seguridad: Mantén tu X-Auth-Token seguro y confidencial.

Facturación Esperada Última actualización: Febrero de 2025

La API `factesp` permite consultar el historial de facturación específica para proyectos, con detalles personalizados según la estructura de cada cliente.

🛡️ Requisitos de Autenticación:

Esta API requiere el encabezado X-Auth-Token para la autenticación.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/factesp

📝 Parámetros de Consulta

Parámetro Tipo Descripción Obligatorio
X-Auth-Token Header Clave de autenticación ✅ Sí

📥 Ejemplo de Solicitud (Request)

Consulta facturación específica para un proyecto usando Python:

import requests

url = "https://tiemposrsm.com/API/v2/factesp"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

{
  "status": "success",
  "total": 2,
  "data": [
    {
      "idFactura": 202401,
      "idProy": 12345,
      "mes": 1,
      "monto": 15000.00,
      "moneda": "MXN",
      "fechaEmision": "2024-01-15"
    },
    {
      "idFactura": 202402,
      "idProy": 12345,
      "mes": 2,
      "monto": 17000.00,
      "moneda": "MXN",
      "fechaEmision": "2024-02-16"
    }
  ]
}

🚨 Posibles Errores

CódigoDescripciónEjemplo
401No autorizado{"error":"API Key inválida"}
404No se encontraron datos{"error":"No se encontraron facturas"}

Facturación Última actualización: Febrero de 2025

La API `facturacion` proporciona un resumen general de todas las facturas emitidas, permitiendo filtrar por cliente, proyecto y rango de fechas.

🛡️ Requisitos de Autenticación:

Requiere el encabezado X-Auth-Token para autenticación.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/facturacion

📝 Parámetros de Consulta

ParámetroTipoDescripciónObligatorio
X-Auth-TokenHeaderClave de autenticación✅ Sí

📥 Ejemplo de Solicitud (Request)

Consulta todas las facturas emitidas para un cliente en un rango de fechas:

import requests

url = "https://tiemposrsm.com/API/v2/facturacion"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}


response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

{
  "status": "success",
  "total": 2,
  "data": [
    {
      "idFactura": 1001,
      "idCliente": 789,
      "idProy": 123,
      "monto": 25000.00,
      "fecha": "2024-03-10"
    },
    {
      "idFactura": 1002,
      "idCliente": 789,
      "idProy": 124,
      "monto": 18000.00,
      "fecha": "2024-05-20"
    }
  ]
}

🚨 Posibles Errores

CódigoDescripciónEjemplo
400Solicitud inválida{"error":"Fechas inválidas"}
401No autorizado{"error":"API Key inválida"}
404Sin resultados{"error":"No se encontraron facturas"}

💡 Notas y Recomendaciones

  • 🛡️ Mantén tu clave de API segura.

Proyectos Última actualización: Febrero de 2025

La API `proyectos` permite consultar el listado general de proyectos activos, incluyendo información básica y fechas clave.

🛡️ Requisitos de Autenticación:

Requiere el encabezado X-Auth-Token para autenticación.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/proyectos

📝 Parámetros de Consulta

ParámetroTipoDescripciónObligatorio
X-Auth-TokenHeaderClave de autenticación✅ Sí

📥 Ejemplo de Solicitud (Request)

import requests

url = "https://tiemposrsm.com/API/v2/proyectos"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

{
  "status": "success",
  "total": 2,
  "data": [
    {
      "idProy": 101,
      "proyecto": "Consultoría Fiscal 2024",
      "descripcion": "Auditoría y revisión fiscal",
      "idCliente": 501,
      "fechaIngreso": "2024-01-15",
      "estado": "Activo"
    },
    {
      "idProy": 102,
      "proyecto": "Implementación ERP",
      "descripcion": "Sistema de gestión empresarial",
      "idCliente": 502,
      "fechaIngreso": "2024-02-20",
      "estado": "Activo"
    }
  ]
}

🚨 Posibles Errores

CódigoDescripciónEjemplo
400Solicitud inválida{"error":"Parámetro inválido"}
401No autorizado{"error":"API Key inválida"}
404No se encontraron proyectos{"error":"Sin resultados"}

Proyectos Esperados Última actualización: Febrero de 2025

La API `proyectosesp` proporciona un detalle extendido de proyectos, incluyendo asignación de horas y gastos adicionales por mes.

🛡️ Requisitos de Autenticación:

Requiere el encabezado X-Auth-Token para autenticación.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/proyectosesp

📝 Parámetros de Consulta

ParámetroTipoDescripciónObligatorio
X-Auth-TokenHeaderClave de autenticación✅ Sí

📥 Ejemplo de Solicitud (Request)

import requests

url = "https://tiemposrsm.com/API/v2/proyectosesp"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

{
  "status": "success",
  "total": 12,
  "data": [
    {
      "mes": 1,
      "horasPresupuestadas": 120,
      "presupuesto": 15000.00,
      "otrosGastos": 500.00,
      "fecha": "2024-01-01"
    },
    {
      "mes": 2,
      "horasPresupuestadas": 130,
      "presupuesto": 15500.00,
      "otrosGastos": 550.00,
      "fecha": "2024-02-01"
    }
  ]
}

🚨 Posibles Errores

CódigoDescripciónEjemplo
401No autorizado{"error":"API Key inválida"}
404No se encontraron datos{"error":"Sin resultados"}

Puestos Última actualización: Febrero de 2025

La API `puestos` proporciona información sobre los puestos dentro de la empresa.

🛡️ Requisitos de Autenticación:

Requiere el encabezado X-Auth-Token para autenticación.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/puestos

📝 Parámetros de Consulta

ParámetroTipoDescripciónObligatorio
X-Auth-TokenHeaderClave de autenticación✅ Sí

📥 Ejemplo de Solicitud (Request)

import requests

url = "https://tiemposrsm.com/API/v2/puestos"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

{
  "status": "success",
  "total": 3,
  "data": [
    {
      "idPuesto": 1,
      "nombre": "Gerente de Proyectos",
      "descripcion": "Responsable de liderar proyectos.",
      "activo": true
    },
    {
      "idPuesto": 2,
      "nombre": "Analista Contable",
      "descripcion": "Encargado del análisis financiero.",
      "activo": true
    },
    {
      "idPuesto": 3,
      "nombre": "Desarrollador Backend",
      "descripcion": "Desarrollo y mantenimiento de APIs.",
      "activo": true
    }
  ]
}

🚨 Posibles Errores

CódigoDescripciónEjemplo
400Solicitud inválida{"error":"Parámetro inválido"}
401No autorizado{"error":"API Key inválida"}
404No se encontraron puestos{"error":"Sin resultados"}

Servicios Última actualización: Febrero de 2025

La API `servicios` permite consultar el catálogo de servicios ofrecidos por la empresa.

🛡️ Requisitos de Autenticación:

Requiere el encabezado X-Auth-Token para autenticación.

📌 URL del Endpoint:
https://tiemposrsm.com/API/v2/servicios

📝 Parámetros de Consulta

ParámetroTipoDescripciónObligatorio
X-Auth-TokenHeaderClave de autenticación✅ Sí

📥 Ejemplo de Solicitud (Request)

import requests

url = "https://tiemposrsm.com/API/v2/servicios"
headers = {
    "X-Auth-Token": "Bearer TU_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

📤 Ejemplo de Respuesta (Response)

{
  "status": "success",
  "total": 2,
  "data": [
    {
      "idServicio": 101,
      "nombre": "Consultoría Fiscal",
      "descripcion": "Asesoría y gestión fiscal para empresas.",
      "categoria": "Consultoría"
    },
    {
      "idServicio": 102,
      "nombre": "Consultoría Legal",
      "descripcion": "Soporte en temas legales y regulatorios.",
      "categoria": "Consultoría"
    }
  ]
}

🚨 Posibles Errores

CódigoDescripciónEjemplo
400Solicitud inválida{"error":"Parámetro inválido"}
401No autorizado{"error":"API Key inválida"}
404No se encontraron servicios{"error":"Sin resultados"}