workflows

Token de sincronización caducado: reconstruye la copia antes de actuar

Distingue el token de cambios de la autenticación, rehace la carga completa y concilia la copia local antes de activar avisos o actualizaciones.

Cuando una API rechaza un token de sincronización incremental, repetir la misma petición puede dejar desactualizada la copia local. Primero distingue un fallo del punto de control de cambios de un problema de autenticación. Después reconstruye la copia según el contrato del proveedor antes de actualizar otros sistemas.

Respuesta breve

La API de Google Calendar puede devolver 410 cuando un syncToken deja de ser válido y exige una sincronización completa del almacén del cliente. La consulta delta de Microsoft Graph también puede requerir una nueva carga tras un reinicio 410 Gone o un token delta vencido. No equivale a renovar el token OAuth. Antes de enviar recordatorios, borrar registros locales o actualizar un CRM a partir de la copia, termina la lectura completa y concilia identificadores, eliminaciones y cambios.

Protocolo en cuatro etapas para liberar la copia

Fase Acción Condición para seguir
Contener Pausa los efectos basados en la copia; registra proveedor, colección, error y datos del punto de control sin exponer el token Confirmar fallo del estado de cambios, no de acceso
Reconstruir Conserva evidencia limitada del estado local; lee la colección completa en una copia de trabajo, con todas las páginas Recibir el marcador final, como nextSyncToken o deltaLink
Conciliar Compara IDs y estados; trata eliminaciones y restauraciones según el proveedor Diferencias importantes explicadas o asignadas a una persona
Reanudar Sustituye la copia local con el método seguro de la integración y recupera los efectos posteriores Muestras y recuentos de control coherentes

Este protocolo es síntesis editorial de Pulse, no una prueba de plataforma ni una orden de borrar el calendario original. La indicación de Google de limpiar el almacén del cliente se refiere a la copia de la aplicación. Conserva por separado las notas que solo existan localmente.

Comprueba el marcador final

Google devuelve nextSyncToken solo en la última página de la carga completa. Si la sincronización incremental tiene varias páginas, mantén los parámetros admitidos y continúa hasta recibir el nuevo token. Graph distingue @odata.nextLink de @odata.deltaLink, puede repetir cambios y marca eliminaciones con @removed en los recursos compatibles. Una primera página o una ausencia temporal no basta para declarar eliminado un registro.

Por ejemplo, una pequeña empresa en España sincroniza reservas de agenda antes de avisar a sus clientes. Si falla el token de cambios, detiene avisos basados en esa copia, la reconstruye y compara IDs antes de reanudar. El mismo criterio técnico sirve a equipos hispanoamericanos con esos endpoints, sin asumir normas nacionales. Es un ejemplo ficticio; Pulse no ejecutó la integración.

Cuándo detenerse

Detente si no puedes identificar la colección del token, si la lectura completa no termina, si cambiaron los parámetros, si una eliminación puede confundirse con lectura parcial o si perderías notas locales. Un 401 de acceso requiere otra revisión: comprueba la conexión. Durante la carga, verifica la paginación. Si ya faltan registros, investiga la brecha.

Fuentes