Classifica il documento
PDF4me Classifica il documento consente di classificare e identificare i documenti in base al loro contenuto. Questo API processi di servizio PDF analizza i file e la struttura dei documenti, i modelli di contenuto e i metadati per determinare i tipi e le categorie dei documenti. API riceve PDF contenuto attraverso REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Grazie al supporto per l'identificazione del tipo di documento e la categorizzazione automatica, questa soluzione è ideale per i sistemi di gestione documentale e i flussi di lavoro automatizzati.
Autenticazione del tuo API Richiesta
Per accedere al PDF4me REST API, ogni richiesta deve includere credenziali di autenticazione adeguate. L'autenticazione garantisce una comunicazione sicura e convalida la tua identità come utente autorizzato del REST API.
Caratteristiche principali
- Classificazione dei documenti: Identificare e classificare i tipi di documento in base all'analisi del contenuto
- Analisi dei contenutiAnalizzare la struttura del documento, i modelli di contenuto e i metadati.
- Diversi tipi di documento: Supporto per vari PDF formati dei documenti
- Elaborazione automatizzataClassificazione semplificata dei documenti senza intervento manuale
- Semplice API Integrazione: RESTful API progettato per flussi di lavoro automatizzati di elaborazione dei documenti
REST API Punto finale
IL PDF4me REST API utilizza standard HTTP Metodi per interagire con le risorse. Tutte le operazioni di classificazione dei documenti vengono eseguite tramite un unico endpoint:
- Metodo: POST
- Punto finale:
/api/v2/ClassifyDocument
REST API Parametri
Elenco completo dei parametri per la classificazione del documento REST APII parametri sono organizzati per categoria per una migliore comprensione e implementazione.
Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori e devono essere forniti per il API per funzionare correttamente.
Parametri richiesti
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| docContent* | Base64 String) | Il contenuto dell'input PDF file codificato in Base64 formato per l'analisi e la classificazione dei documenti | JVBERi... |
| docName* | String | Fonte PDF Nome del file con estensione .pdf corretta per l'identificazione e l'elaborazione del documento. | output.pdf |
Parametri opzionali
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| async | Boolean | Abilita l'elaborazione asincrona. Quando true, IL API resi 202 Accepted con un Location intestazione per il sondaggio del risultato | true |
Produzione
IL PDF4me Classifica il documento REST API restituisce risposte diverse a seconda della modalità di elaborazione. API restituisce i dati di classificazione come JSON risposta.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Elaborazione sincrona (impostazione predefinita)
Quando async È false o non fornito, il API restituisce immediatamente i risultati della classificazione.
Codice di stato: 200 OK
Formato di risposta:
{
"documentType": "invoice",
"category": "financial",
"confidence": 0.95,
"metadata": {
"pageCount": 1,
"createdDate": "2024-01-15T10:30:00Z"
}
}
La risposta contiene dati di classificazione, tra cui tipo di documento, categoria, punteggio di affidabilità e informazioni sui metadati.
Elaborazione asincrona
Quando async È true, IL API elabora il documento in modo asincrono.
Risposta iniziale:
Codice di stato: 202 Accepted
Intestazioni di risposta:
Location: https://api.pdf4me.com/api/v2/ParseDocumentStatus/{operationId}
Corpo della risposta:
{
"traceId": "operation-trace-id"
}
Sondaggio per i risultati:
Utilizzare il Location intestazione URL per votare il completamento:
const response = await fetch(locationUrl, {
headers: { 'Authorization': 'Basic ' + apiKey }
});
// Continue polling until status code is 200
if (response.status === 200) {
const result = await response.json();
// Process classification results
}
Risposte di errore
| Codice di stato | Descrizione | Esempio di risposta |
|---|---|---|
| 400 Bad Request | Parametri di richiesta non validi o campi obbligatori mancanti | {"error": "Missing required parameter: docContent"} |
| 401 Unauthorized | Non valido o mancante API chiave | {"error": "Unauthorized"} |
| 408 Timeout della richiesta | Timeout di elaborazione della richiesta | {"error": "Request timeout"} |
| 500 Internal Server Error | Errore del server durante l'elaborazione | {"error": "Internal server error"} |
Comprendere il JSON Risposta
La risposta di classificazione è una JSON oggetto contenente dati strutturati relativi al documento:
- tipo di documento: Il tipo di documento identificato (ad esempio, "fattura", "contratto", "rapporto")
- categoria: La categoria del documento (ad esempio, "finanziario", "legale", "commerciale")
- fiducia: Un punteggio che indica il livello di affidabilità della classificazione (da 0,0 a 1,0)
- metadatiInformazioni aggiuntive sul documento, come il numero di pagine, la data di creazione, ecc.
Codifica Base64 Contenuto (se presente):
Se la risposta include Base64-contenuto codificato, decodificalo utilizzando:
// JavaScript
const decoded = atob(base64String);
# Python
import base64
decoded = base64.b64decode(base64_string).decode('utf-8')
Esempio di richiesta
Intestazione
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Nota:
- Ottieni il tuo API chiave dalla PDF4me Pannello di controllo
- IL API la chiave deve essere Base64 codificato e prefissato con "Basic" nel Authorization intestazione
- Esempio: se il tuo API la chiave è
abc123, codificalo in Base64 e utilizzareAuthorization: Basic YWJjMTIz
Carico utile
Richiesta di base:
{
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"docName": "output.pdf"
}
Con elaborazione asincrona:
{
"docContent": "JVBERi0xLjQKJeLjz9MK...",
"docName": "output.pdf",
"async": true
}
Esempi di codice
IL PDF4me Classifica il documento REST API Fornisce esempi di codice in diversi linguaggi di programmazione. Scegli il linguaggio più adatto al tuo ambiente di sviluppo:
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
Java Campione
Java implementazione con gestione completa degli errori ed elaborazione delle risposte:
JavaScript Campione
Node.js e compatibile con i browser JavaScript implementazione:
Google Script Campione
Google Apps Script implementazione per Google Workspace integrazione:
Caratteristiche di classificazione dei documenti
Capacità di classificazione
- Rilevamento del tipo di documentoIdentificazione delle tipologie di documenti basata sull'analisi del contenuto
- Categorizzazione dei contenutiRaggruppamento di documenti in base al contenuto e allo scopo
- Riconoscimento del modelloIdentificazione di modelli di documenti e formati standard
- Classificazione di conformitàClassificazione ai fini dei requisiti normativi e di conformità
Funzionalità aziendali
- Elaborazione in batch: Elaborare più documenti con standard di classificazione coerenti
- Garanzia di qualitàGarantire l'accuratezza e l'affidabilità della classificazione per le applicazioni aziendali
- Integrazione prontaIntegrazione perfetta con i sistemi di gestione documentale esistenti
- Elaborazione scalabileGestisci grandi volumi di documenti con prestazioni di livello aziendale.
Casi d'uso e applicazioni industriali
- Document Management & Organization
- Compliance & Regulatory
- Business Process Automation
- Financial Services
- Healthcare & Medical
- Legal & Professional Services
Casi d'uso per la gestione e l'organizzazione dei documenti
- Archiviazione automatizzataClassificazione e organizzazione automatica dei documenti nei sistemi di archiviazione digitale
- Gestione dei contenuti: Categorizzazione avanzata per sistemi di gestione e recupero dei contenuti
- Organizzazione dell'archivioClassificazione sistematica di documenti e registri storici
- Ottimizzazione della ricercaRicerca documenti migliorata grazie a classificazione e tag accurati.
Casi d'uso relativi alla conformità e alla regolamentazione.
- Preparazione della revisione contabileClassificazione automatica dei documenti a fini di conformità e audit.
- Segnalazione normativaProcedure semplificate per la presentazione di documenti normativi.
- Scoperta legaleClassificazione efficiente dei documenti per la fase istruttoria e il supporto al contenzioso.
- Conformità alle normeVerifica automatizzata della conformità dei documenti alle politiche aziendali.
Casi d'uso dell'automazione dei processi aziendali
- Instradamento del flusso di lavoro: Instradamento automatico dei documenti in base ai risultati della classificazione
- Ottimizzazione dei processiFlussi di lavoro semplificati per l'elaborazione dei documenti con classificazione avanzata
- Controllo qualitàVerifica automatizzata dei tipi di documento e dell'accuratezza del contenuto
- Allocazione delle risorseAllocazione efficiente delle risorse di elaborazione in base alle tipologie di documento.
Casi d'uso nei servizi finanziari
- Elaborazione delle fattureClassificazione automatica di fatture, ricevute e documenti finanziari.
- Documentazione relativa al prestitoProcedure semplificate per la gestione delle richieste di prestito e della relativa documentazione di supporto.
- Preparazione delle dichiarazioni dei redditiClassificazione automatizzata di documenti e moduli fiscali
- Supporto alla conformità: Organizzazione efficiente della documentazione per audit e revisioni finanziarie
Casi d'uso in ambito sanitario e medico
- Cartelle cliniche dei pazientiClassificazione automatica delle cartelle cliniche e della documentazione dei pazienti
- richieste di risarcimento assicurativoProcedure semplificate per la gestione delle richieste di risarcimento assicurativo e della documentazione medica.
- Documentazione di conformitàClassificazione automatizzata per la conformità normativa nel settore sanitario
- Dati di ricerca: Organizzazione sistematica della documentazione relativa alla ricerca medica e alle sperimentazioni cliniche
Casi d'uso per servizi legali e professionali
- Gestione dei contrattiClassificazione automatica di contratti e accordi legali
- Documentazione del caso: Organizzazione efficiente dei fascicoli legali e della documentazione di supporto
- Monitoraggio della conformitàClassificazione automatizzata per la conformità normativa e il monitoraggio
- Documentazione per il clienteGestione semplificata dei fascicoli dei clienti e della documentazione professionale.