Saltar al contenido principal

System

GET /v2/health

Service health

Always answers 200, even during maintenance — the body carries the state. A MAINTENANCE status means every other route is returning 503, so poll this to know when to resume instead of probing a real endpoint.

Respuestas

CódigoDescripciónCuerpo
200Éxito.HealthResponse
500application/problem+json (RFC 9457) — branch on code, not on the status: internal_error (retryable).

GET /v2/time

Server time for request signing and clock synchronization

Respuestas

CódigoDescripciónCuerpo
200Éxito.TimeResponse
500application/problem+json (RFC 9457) — branch on code, not on the status: internal_error (retryable).

Esquemas

HealthResponse

CampoTipoDescripción
statusUP | MAINTENANCEUP when serving normally. MAINTENANCE when the API is in maintenance — every other route is returning 503 with the maintenance problem type, so retry later rather than treating it as an outage. Ej.: UP.

Problem

CampoTipoDescripción
typestringStable problem-type URI. Resolves to docs for this error. Ej.: https://docs.skipo.com/errors/rate_limited.
titlestringShort, human-readable summary (stable, English). Ej.: Rate limit exceeded.
statusnumberHTTP status code. Ej.: 429.
codestringStable machine-readable error code (equals the last path segment of type). Ej.: rate_limited.
retryablebooleanWhether retrying the identical request may succeed. Ej.: true.
detail (opcional)stringHuman-readable, possibly localized detail.
instance (opcional)stringThe request path that produced the error.
traceId (opcional)stringTrace id — joins BigQuery api_request and Cloud Logging.

TimeResponse

CampoTipoDescripción
serverTimenumberServer time, milliseconds since Unix epoch. Ej.: 1783003522123.
isostringThe same instant as ISO-8601 UTC. Ej.: 2026-07-28T12:34:56.789Z.

Volver a la referencia de endpoints. Ver también: Paginación · Errores · Ids y correlación.