Cerca...
  • Prezzi
Inizia ora

Inizia a digitare per cercare tra modelli, sites e articoli del blog...

Documentazione di metagrapho

Introduzione

\r\n

L'API Transkribus facilita l'elaborazione di immagini utilizzando la tecnologia Transkribus HTR (Handwritten Text Recognition). Con questa API, gli utenti possono inviare immagini per l'elaborazione e successivamente recuperare i risultati utilizzando il processId fornito.

\r\n\r\n

Autenticazione

\r\n

Per interagire con l'API Transkribus, devi prima autenticarti per ottenere un token di accesso. L'API utilizza il protocollo OpenID Connect per l'autenticazione. Ecco una guida passo dopo passo per ottenere e gestire i tuoi token di accesso.

\r\n\r\n

Per alcune librerie, potresti richiedere l'URL di configurazione OpenID Connect, che è disponibile presso: https://account.readcoop.eu/auth/realms/readcoop/.well-known/openid-configuration

\r\n \r\n

1. Ottieni un token di accesso

\r\n

Utilizza il seguente comando cURL, sostituendo $USERNAME e $PASSWORD con le tue credenziali:

\r\n 
\r\ncurl --location --request POST https://account.readcoop.eu/auth/realms/readcoop/protocol/openid-connect/token \\\r\n--header 'Content-Type: application/x-www-form-urlencoded' \\\r\n--data-urlencode grant_type=password \\\r\n--data-urlencode username=$USERNAME \\\r\n--data-urlencode password=$PASSWORD \\\r\n--data-urlencode client_id=processing-api-client\r\n
\r\n

Dopo l'autenticazione riuscita, riceverai un token di accesso nella risposta. Inoltre, riceverai un token di aggiornamento che può essere utilizzato per ottenere un nuovo token di accesso una volta scaduto quello attuale.

\r\n\r\n

2. Aggiornamento del token di accesso

\r\n

Se il tuo token di accesso scade, puoi utilizzare il token di aggiornamento fornito per ottenerne uno nuovo con questo comando:

\r\n 
\r\ncurl --location --request POST https://account.readcoop.eu/auth/realms/readcoop/protocol/openid-connect/token \\\r\n--header 'Content-Type: application/x-www-form-urlencoded' \\\r\n--data-urlencode grant_type=refresh_token \\\r\n--data-urlencode client_id=processing-api-client \\\r\n--data-urlencode refresh_token=$REFRESH_TOKEN\r\n
\r\n

Sostituisci $REFRESH_TOKEN con il tuo token di aggiornamento. Aggiorna il tuo token di aggiornamento se la risposta ne contiene uno nuovo.

\r\n\r\n

3. Terminazione della sessione

\r\n

Per disconnettersi e invalidare il token di aggiornamento, utilizza:

\r\n 
\r\ncurl --location --request POST https://account.readcoop.eu/auth/realms/readcoop/protocol/openid-connect/logout \\\r\n--header 'Content-Type: application/x-www-form-urlencoded' \\\r\n--data-urlencode refresh_token=$REFRESH_TOKEN \\\r\n--data-urlencode client_id=processing-api-client\r\n
\r\n\r\n

Informazioni di fatturazione

\r\n

Per impostazione predefinita, l'API Transkribus utilizza il sistema di credito interno di Transkribus per la fatturazione. Tuttavia, su richiesta, è possibile predisporre un sistema di fatturazione Pay-Per-Use.

\r\n

Domande frequenti

Le pagine inviate all'endpoint rimangono accessibili per un massimo di 2 giorni. Dopo questo periodo, riceverai una risposta '404 Not Found' se provi ad accedervi.

Le immagini o le pagine non vengono eliminate immediatamente dopo il processo di riconoscimento del testo scritto a mano (HTR). Seguono la stessa politica di conservazione di 2 giorni come menzionato sopra.

Sì, il modello di prezzo è diverso a causa della non dipendenza dalla capacità di archiviazione. Per una ripartizione dettagliata, fare riferimento al seguente documento.

A partire dalla versione ≥ 0.8.0, vengono applicate le stesse restrizioni sull'utilizzo del modello come sulla piattaforma Transkribus. Ciò significa che gli account API devono essere aggiunti alle collezioni in cui i modelli privati sono collegati per l'accesso.