Saltar al contenido principal

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]

sugerencia

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,

Ir a la referencia de la API de Documentos.

Export This Article

Save a copy of this page as PDF or plain text.