Health check (ping)

GET /api/v1/ping

Endpoint de diagnóstico. Permite verificar que el servicio está vivo y respondiendo, sin necesidad de autenticarse. Útil para monitoreo y para validar conectividad antes de llamar a los endpoints protegidos.

Solicitud

Atributo	Valor
Método	`GET`
Ruta	`/api/v1/ping`
Autenticación	No requerida
Rate limit	General (60/min por IP)

Método GET
URL: https://<dominio-hosana>/api/v1/ping
No requiere headers. Pulsa Send.

curl -X GET "https://<dominio-hosana>/api/v1/ping"

$response = $client->get('ping');
$data = json_decode($response->getBody(), true);
echo $data['status']; // "ok"

const res = await fetch("https://<dominio-hosana>/api/v1/ping");
const data = await res.json();
console.log(data.status); // "ok"

var data = await http.GetFromJsonAsync<JsonElement>("ping");
Console.WriteLine(data.GetProperty("status").GetString()); // "ok"

Respuesta

HTTP 200

{
  "status": "ok",
  "service": "Distribuidora Hosana API",
  "version": "v1",
  "timestamp": "2026-06-06T08:30:00-06:00"
}

Campo	Tipo	Descripción
`status`	string	Siempre `"ok"` si el servicio responde.
`service`	string	Nombre del servicio.
`version`	string	Versión del API (`"v1"`).
`timestamp`	string	Hora del servidor en formato ISO 8601 (con offset).