Come fare una sincronizzazione notturna

Problema / Soluzione

Problema: I webhook stanno aggiornando il tuo sistema ma devi essere doppiamente sicuro che tutti i tuoi documenti siano sincronizzati correttamente.

Soluzione: Una query sui documenti che puoi eseguire ogni notte e che restituisce tutto ciò che è successo dalla notte precedente.

Come fare

Semplicemente aggiungi 'modified_gt=' alla query /api/v1/document.

es. Ottieni fino a 500 documenti modificati da una data e ora precedente (senza dettagli sui firmatari).

/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]

suggerimento

Questa query include il parametro nosigners=1. Se non ti serve l'informazione sullo stato del firmatario (potresti aver bisogno solo dello stato del documento) questo renderà la tua query molto più veloce. Velocizza ulteriormente usando un valore limit elevato. (Vai al riferimento sullo stato del documento).

Il parametro offset itera la lista. Itera facilmente i tuoi documenti ottenendo l'URL successivo da interrogare dall'elemento 'next' all'interno dell'oggetto 'meta' della risposta. Quando il valore next è null non ci sono più elementi da ottenere.

Esempio di risposta che include '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,

Vai al riferimento Document API.