Estado del servicio (ping)

Comprobación rápida de que un servicio de Panteum responde. Sirve para monitoreo propio, para diagnosticar problemas de conectividad desde tu red y como primera prueba al integrarte. No devuelve datos de negocio.

• Autenticación: ninguna.
• Disponible en: solicitudes, presupuesto, archivos, calidad y mcp.
• URL: https://<servicio>.tu-entidad.example/api/v1/ping (reemplaza <servicio>; ver Conceptos).

---

GET /api/v1/ping

Parámetros

Ninguno.

Ejemplos

curl

curl -s https://solicitudes.tu-entidad.example/api/v1/ping

JavaScript (fetch)

const res = await fetch("https://solicitudes.tu-entidad.example/api/v1/ping");
const cuerpo = await res.json();
console.log(res.status, cuerpo);

Python (requests)

import requests

r = requests.get("https://solicitudes.tu-entidad.example/api/v1/ping", timeout=5)
print(r.status_code, r.json())

Respuesta de ejemplo (200)

{
  "success": true,
  "data": {
    "servicio": "sgi-solicitudes",
    "ts": "2026-10-05T11:19:53-05:00"
  },
  "message": "pong"
}

Campo	Descripción
data.servicio	Nombre interno del servicio que respondió.
data.ts	Hora del servidor (ISO 8601). Útil para detectar desfases de reloj.

Nota de compatibilidad: hoy el servicio archivos responde { "ok": true, "servicio": "...", "ts": "..." } sin el envoltorio success/data/message, y presupuesto agrega data.ok: true. Si monitoreas varios servicios, valida únicamente el código HTTP 200 y no la forma exacta del cuerpo.

Errores

HTTP	error.code	Cuándo
429	RATE_LIMIT	Demasiadas peticiones desde tu IP. Respeta Retry-After.
5xx	ERROR_INTERNO / sin respuesta	El servicio no está disponible.

Buena práctica: consulta el ping como máximo una vez cada 30–60 segundos desde tu monitor.