Cómo hacer una sincronización nocturna
Problema / Solución
Problema: Los webhooks están actualizando tu sistema pero necesitas estar doblemente seguro de que todos tus documentos están sincronizados correctamente.
Solución: Una consulta de documentos que puedes ejecutar cada noche y que devuelve todo lo que ocurrió desde la noche anterior.
Cómo hacerlo
Simplemente añade 'modified_gt=' a la consulta /api/v1/document.
p.ej. Obtener hasta 500 documentos modificados desde una fecha y hora anterior (sin detalles de firmantes).
/api/v1/document/?group=your-group&nosigners=1&limit=500&modified_gt=[datetime of last query]
/api/v1/document/?group=your-group&nosigners=1&limit=500&offset=500&modified_gt=[datetime of last query]
Esta consulta incluye el parámetro nosigners=1. Si no necesitas información del estado de los firmantes (puede que solo necesites el estado del documento) esto hará que tu consulta sea mucho más rápida. Acelera aún más usando un valor limit grande. (Ir a la referencia de estado de documento).
El parámetro offset itera la lista. Itera fácilmente tus documentos obteniendo la siguiente URL para consultar desde el elemento 'next' dentro del objeto 'meta' de una respuesta. Cuando el valor next es null no quedan más elementos por obtener.
Ejemplo de respuesta incluyendo 'meta':
{
"meta": {
"limit": 20,
"next": "/api/v1/document/?limit=20&offset=40&group=xxxx",
"offset": 20,
"previous": "/api/v1/document/?limit=20&offset=0&group=xxxx",
"total_count": 192
},
"objects": [
{
"archived": false,