GET/api/readyz

Readiness probe

Kubernetes readiness endpoint for the Next.js API route. It checks database connectivity with SELECT 1 and returns 200 only when critical dependencies are available. The Redis check is currently a placeholder that mirrors the database result. This endpoint is unauthenticated and is explicitly skipped by API-key middleware.

Response body

Success response 200 · schema ReadyzReadyResponse

statusstringRequired

All critical dependencies checked by this handler are available.

Enum: ready

timestampstring <date-time>Required

ISO timestamp generated when the readiness check is handled.

uptimenumberRequired

Process uptime in seconds from process.uptime().

≥ 0

versionstringRequired

Application version from npm_package_version, with handler fallback.

checksobjectRequired

databasebooleanRequired

True when a SELECT 1 database connectivity check succeeds.

redisbooleanRequired

Redis readiness placeholder. Currently mirrors the database check result.

Response codes

200

All critical dependencies checked by this handler are available.

503

One or more critical dependencies are unavailable, or a readiness check threw an exception.

GET /api/readyz

cURL

curl -X GET "https://algapsa.com/api/readyz" \
  -H "X-API-Key: $ALGA_API_KEY"

TypeScript

const response = await fetch("https://algapsa.com/api/readyz", {
  method: "GET",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://algapsa.com/api/readyz");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "status": "ready",
  "timestamp": "2026-04-18T15:22:14Z",
  "uptime": 0,
  "version": "string",
  "checks": {
    "database": false,
    "redis": false
  }
}