crisphive
ReservasSondear solicitudes de trabajo nuevas y modificadas (feed de sincronización)

Sondear solicitudes de trabajo nuevas y modificadas (feed de sincronización)

Mantenga su propia copia de las reservas sincronizada SIN volver a listar todo: devuelve las solicitudes de trabajo cuyo estado cambió (creación, transición de estado, reprogramación, soft-delete/archivado) en o después del cursor `since`, ordenadas del cambio más antiguo al más reciente (updated_at ASC). Cómo usarlo: (1) En su primer sondeo OMITA `since` — el servidor inicializa el cursor en «ahora», no devuelve elementos y sí un `next_since`. (2) Guarde `next_since` y páselo como `since` en el siguiente sondeo. (3) Aplique cada elemento devuelto a su almacén haciendo UPSERT por `id` (el servidor vuelve a explorar una ventana de seguridad de ~5 s, por lo que el mismo trabajo puede aparecer de nuevo — nunca lo añada a ciegas). (4) Si `has_more` es true, la página se llenó hasta `limit` y ya hay más cambios en espera — sondee de nuevo de inmediato; de lo contrario, espere su intervalo habitual (p. ej., 5–15 s). Esto NO es paginación — es un feed de cambios indexado por tiempo. Use el GET /job-requests paginado para la carga masiva inicial y luego este endpoint para mantenerse al día. Los filtros (status_keys, customer_id, …) acotan el feed a la porción que le interesa.

Argumentos

status_keysstringqueryopcional
Slugs de estado separados por comas — solo muestra cambios de trabajos en estos estados
prioritystringqueryopcional
Filtro de prioridad (normal|emergency)
customer_idstringqueryopcional
Solo cambios de los trabajos de este cliente (UUID)
technician_idstringqueryopcional
Solo cambios de trabajos asignados a este técnico (UUID)
scheduled_fromstringqueryopcional
Filtrar desde (YYYY-MM-DD o RFC3339); el rango es [from, to)
scheduled_tostringqueryopcional
Filtrar hasta (YYYY-MM-DD o RFC3339), exclusivo
sincestringqueryopcional
Cursor RFC3339 del next_since de la respuesta anterior. OMÍTALO en el primer sondeo para inicializar el cursor en el «ahora» del servidor.
limitintegerqueryopcional
Máximo de cambios por sondeo (por defecto 15, máx. 1000). Si la página se llena, has_more=true.
GET/v1/job-requests/changes
curl -X GET "https://api.crisphive.com/v1/job-requests/changes" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"

Respuestas