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ódigo | Descripción | Cuerpo |
|---|---|---|
200 | Éxito. | HealthResponse |
500 | application/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ódigo | Descripción | Cuerpo |
|---|---|---|
200 | Éxito. | TimeResponse |
500 | application/problem+json (RFC 9457) — branch on code, not on the status: internal_error (retryable). | — |
Esquemas
HealthResponse
| Campo | Tipo | Descripción |
|---|---|---|
status | UP | MAINTENANCE | UP 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
| Campo | Tipo | Descripción |
|---|---|---|
type | string | Stable problem-type URI. Resolves to docs for this error. Ej.: https://docs.skipo.com/errors/rate_limited. |
title | string | Short, human-readable summary (stable, English). Ej.: Rate limit exceeded. |
status | number | HTTP status code. Ej.: 429. |
code | string | Stable machine-readable error code (equals the last path segment of type). Ej.: rate_limited. |
retryable | boolean | Whether retrying the identical request may succeed. Ej.: true. |
detail (opcional) | string | Human-readable, possibly localized detail. |
instance (opcional) | string | The request path that produced the error. |
traceId (opcional) | string | Trace id — joins BigQuery api_request and Cloud Logging. |
TimeResponse
| Campo | Tipo | Descripción |
|---|---|---|
serverTime | number | Server time, milliseconds since Unix epoch. Ej.: 1783003522123. |
iso | string | The 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.