
Ricerca e documenti
Parte di Integrare l'IA nei processi
Verificare API ed esportazioni
Controlli su accesso API, campi, limiti, errori e utilità dei dati esportati prima di collegare uno strumento IA.
undefined
Prima di collegare uno strumento IA a un processo, verificate due capacità: che l'API scambi correttamente i dati necessari e che i dati siano recuperabili in un formato utilizzabile. Un comando «Esporta» non garantisce flussi automatici; una risposta API ben formata non garantisce valori esatti. Le prove si conducono con un client REST come Postman, Insomnia o cURL, non leggendo la documentazione.
Scrivere il contratto minimo
Per ogni operazione specificate input, output, ID caso, autenticazione, dimensioni ammesse e comportamento atteso in caso di errore. Tra i metodi di autenticazione ricorrenti ci sono la chiave API, l'autenticazione di base HTTP, OAuth 2.0 e JWT (IBM). Verificate la disponibilità dell'API nel prodotto, piano e account previsti: un abbonamento alla chat può avere condizioni diverse dall'API.
Preparate i campi richiesti dal sistema successivo: identificativo, categoria proposta e stato del controllo umano, per esempio. Decidete come rappresentare un dato assente.
Se l'API offre output strutturati, verificate i vincoli di schema supportati. Potrebbero esserci limitazioni rispetto allo schema completo; rifiuti e risposte incomplete richiedono gestione separata. Anche un output conforme allo schema può contenere una categoria errata.
Verifica / Esito da ottenere
- Accesso
- Chiave o token validi: risposta con codice 200.
- Autorizzazione
- Credenziale autenticata ma senza permesso: codice 403.
- Errori
- Richiesta non valida: codice 4xx; errore del server: codice 500.
- Limiti
- Troppe richieste: codice 429.
- Esportazione
- File CSV o JSON apribile con uno strumento indipendente.
Verifica degli esiti attesi per accesso, autorizzazione e errori API
- Errori
- Richiesta non valida: codice 4xx; errore del server: codice 500
- Limiti
- Troppe richieste: codice 429
- Esportazione
- File CSV o JSON apribile con uno strumento indipendente
Controllare errori e carico
Leggete i limiti del servizio per organizzazione e progetto, poi verificate quelli mostrati nell'account. Nell'API OpenAI i limiti variano per modello e possono essere definiti a livello di organizzazione e progetto; i valori da controllare sotto carico sono quelli mostrati nel developer console. Le metriche possono riguardare richieste e token per minuto o per giorno.
Predisponete casi con input valido, incompleto e da respingere. Se il collegamento usa webhook, verificate firma, ritentativi e possibili duplicati nella documentazione specifica. Un caso tipico è la firma HMAC-SHA256: il modulo PrestaShop di DataFirefly invia l'intestazione X-DFFB-Signature con sha256= seguito dal valore calcolato sul corpo (datafirefly.com); i webhook OpenAI seguono la specifica Standard Webhooks (developers.openai.com).
Il sistema di destinazione deve poter riconoscere un evento già acquisito, altrimenti un ritentativo genera un duplicato. Per ogni errore annotate il codice HTTP osservato e la ripresa prevista, senza duplicare il caso.
Aprire le esportazioni fuori dal prodotto
Definite prima ciò che dovrete recuperare: input originali, risultati approvati, identificativi, date, stato, correzioni e metadati necessari. Chiedete un'esportazione di prova autorizzata e apritela con uno strumento indipendente. I formati ricorrenti sono CSV e JSON: controllate record mancanti, caratteri italiani, date e relazioni tra record.
Distinguete un archivio della cronologia dell'account da un'esportazione operativa per un altro sistema.
Un'esportazione operativa segue il tracciato richiesto dal software di destinazione: NOX ERP, per esempio, esporta la contabilità nei formati dei principali gestionali italiani, da Profis a Zucchetti, Datev Koinos, TeamSystem, Sistema, Bluenext e OSRA (erp-nox.com). Una cronologia scaricata dall'account potrebbe non contenere i campi richiesti dal gestionale.
Per ogni operazione registrate un esito: verificata, da configurare, non disponibile nel piano oppure non dimostrata. Un campo necessario assente o un errore non gestito lascia il collegamento non dimostrato.



