# TrueScreen API

API TrueScreen per la creazione di TrueFlow e la certificazione

Version: 1.5.0
License: Commercial

## Servers

```
https://api-stg.truescreen.io
```

```
https://api.truescreen.io
```

## Security

### ApiKeyAuth

Chiave API passata nell'header Authorization come token Bearer

Type: http
Scheme: bearer
Bearer Format: API Key

## Download OpenAPI description

[TrueScreen API](https://truescreen.redocly.app/_bundle/@l10n/it/openapi.yaml)

## Credits

Saldo crediti

### Ottieni crediti

 - [GET /v1/credits](https://truescreen.redocly.app/it/openapi/credits/creditsget.md): Restituisce il saldo crediti corrente per la chiave API

## Certifications

Certificazioni file e hash (certificazioni)

### Crea una certificazione file

 - [POST /v1/file-certifications](https://truescreen.redocly.app/it/openapi/certifications/filecertificationspost.md): Crea una nuova certificazione da file caricati (sessione di upload)

### Crea allegati certificazione file

 - [POST /v1/file-certifications-attachments](https://truescreen.redocly.app/it/openapi/certifications/filecertificationsattachmentspost.md): Richiedi URL di upload per i file da includere in una certificazione file

### Crea una certificazione hash

 - [POST /v1/hash-certifications](https://truescreen.redocly.app/it/openapi/certifications/hashcertificationspost.md): Crea una nuova certificazione da hash di file (senza upload)

### Crea una certificazione dati

 - [POST /v1/data-certifications](https://truescreen.redocly.app/it/openapi/certifications/datacertificationspost.md): Crea una nuova certificazione da dati chiave-valore in formato stringa (senza file né hash)

### Ottieni certificazione per ID report

 - [GET /v1/certifications/{reportId}](https://truescreen.redocly.app/it/openapi/certifications/certificationsgetbyreportid.md): Restituisce una certificazione per il suo ID report. Durante l'elaborazione o al completamento, gli URL di download firmati sono nell'array files.

Se l'elaborazione fallisce in modo asincrono (dopo che il POST di creazione è andato a buon fine), l'API risponde con un codice HTTP coerente con il tipo di errore (ad es. 5xx) e un corpo application/problem+json con la stessa forma ErrorResponseRfc degli altri errori.

Il 404 si applica quando il reportId non esiste o non è visibile al chiamante.

### Callback webhook certificazione

 - [POST certificationCallback](https://truescreen.redocly.app/it/openapi/certifications/certificationcallback.md): Inviato al webhook_url quando l'elaborazione della certificazione termina (successo o errore).
Segue la specifica Standard Webhooks.
Il payload usa un envelope standard con campi type, timestamp e data.
Ogni callback è firmata con HMAC-SHA256 tramite gli header webhook-id, webhook-timestamp e webhook-signature.

Autenticazione: questa è una callback server-to-client, l'autenticità si verifica tramite l'header webhook-signature usando un signing secret dedicato (prefisso whsec_).

## TrueFlows

True Flow

### Elenca template

 - [GET /v1/templates](https://truescreen.redocly.app/it/openapi/trueflows/templatesgetall.md): Restituisce l'elenco dei template di flusso disponibili per la chiave API

### Crea un TrueFlow

 - [POST /v1/true-flows](https://truescreen.redocly.app/it/openapi/trueflows/trueflowspost.md): Crea un nuovo TrueFlow da un template

### Crea allegato TrueFlow

 - [POST /v1/true-flows-attachments](https://truescreen.redocly.app/it/openapi/trueflows/trueflowsattachmentspost.md): Crea un allegato per un TrueFlow