Vai al contenuto principale
Uno scenario tipico per elaborare documenti utilizzando chiamate API separate (per creare una transazione, caricare un file e avviare la transazione) prevede i seguenti passaggi:
  1. Ricevere un elenco di tutte le skill disponibili
  2. Creare una transazione vuota
  3. Aggiungere un set di file da elaborare nella transazione
  4. Avviare la transazione
  5. Monitorare lo stato della transazione
  6. Scaricare i file sorgente e i file di risultato
Ogni richiesta al server deve includere le informazioni di autenticazione (ad esempio un token di accesso). Per ulteriori informazioni, consultare Authentication.

​
Ottenere un elenco di tutte le skill disponibili

Per farlo, invia una richiesta GET alla risorsa skills: Esegui il seguente comando: Di conseguenza, riceverai informazioni su tutte le skill aggiunte all’istanza dell’applicazione.

​
Creare una transaction vuota

Per farlo, invia la seguente richiesta POST alla risorsa transactions: Esegui il comando seguente: Nel body della richiesta, specifica il Parameter skillId restituito dalla chiamata API precedente. Come risultato, riceverai una risposta contenente l’id della transaction creata.

​
Aggiunta di un set di file da elaborare nella transaction

Importante! Il numero massimo di file in una transaction è 1000. Un set di file può essere aggiunto in due modi:

​
Aggiunta di file direttamente alla transaction

Per farlo, invia una richiesta POST alla risorsa transactions/<transaction-id>/files: Eseguire il comando seguente: Di conseguenza, riceverai una risposta con l’elenco dei file aggiunti e dei loro identificatori. Puoi aggiungere quanti file desideri ripetendo questa chiamata più volte. Opzioni aggiuntive per il caricamento dei file:

​
Aggiunta di file a un documento

Per prima cosa, crea un documento inviando una richiesta POST alla risorsa transactions/<transaction-id>/documents: Di conseguenza, riceverai una risposta con l’identificatore del documento. Quindi aggiungi i file al documento inviando una richiesta POST alla risorsa transactions/<transaction-id>/documents/<document-id>/sourceFiles:

​
Avvio della Transaction

Per avviare la Transaction con la skill e i file specificati, inviare la seguente richiesta POST alla risorsa transactions/&lt;transaction-id&gt;/start:

​
Monitorare lo stato della transaction

Per monitorare lo stato della transaction utilizzando un ciclo con un breve timeout (sconsigliamo di controllare lo stato più di una volta al secondo), invia una richiesta GET alla risorsa transactions/<transaction_id> includendo l’identificatore della transaction nell’URI della richiesta: Di conseguenza, riceverai una risposta contenente lo stato della transaction. L’elaborazione della transaction può trovarsi in uno dei seguenti stati:
  • New. La transaction è stata creata ma non è ancora stata messa in coda per l’elaborazione.
  • Queued. La transaction è in coda per l’elaborazione.
  • InProgress. La transaction è in fase di elaborazione.
  • Processed. La transaction è stata elaborata correttamente.
  • ProcessedWithWarnings. La transaction è stata elaborata, ma si sono verificati degli avvisi.
  • NotProcessed. La transaction non è stata elaborata a causa di un errore.
  • Deleted. La transaction è stata eliminata dall’utente o automaticamente secondo i criteri di conservazione.
Se lo stato della transaction è Processed o ProcessedWithWarnings, vai al passaggio 6.

​
Download dei file sorgente

Per ottenere un elenco di documenti con i relativi identificatori, invia una richiesta GET alla risorsa transactions/<transaction-id>/documents e specifica l’identificatore della transaction: Di conseguenza, riceverai un elenco di tutti i documenti creati all’interno di questa transaction. La risposta contiene anche gli identificatori di questi documenti, che potrebbero servirti per richiedere informazioni dettagliate su documenti specifici. Per ottenere l’elenco dei file aggiunti a un documento specifico, invia una richiesta GET alla risorsa transactions/<transaction-id>/documents/<document-id>: Di conseguenza, riceverai informazioni sul documento. La risposta include anche gli identificatori dei file aggiunti al documento. Per scaricare il file di origine, invia una richiesta GET alla risorsa transactions/<transaction-id>/files/<file-id>/download: