> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Nuovo tentativo report asincrono API > Riprova un export asincrono Didit o le verifiche fallite: accesso solo al richiedente, sessioni eliminate escluse, gestione dei replay. L'API Reports asincrona di Didit riesegue un'esportazione oppure accoda gli elementi di verifica non riusciti selezionati. Un nuovo tentativo restituisce `201`; una selezione identica di elementi non riusciti restituisce il report esistente con `200`. > [!WARNING] > > Il nuovo tentativo selettivo richiede l'identità dell'utente richiedente originale. Una chiave API o un token dell'applicazione senza tale identità riceve `403` quando invia `item_ids`, anche per la propria applicazione. L'esempio generato per la chiave API riesegue l'intera esportazione con un corpo vuoto. Leggi gli ID attivi da [Recupera report asincrono](https://docs.didit.me/it/management-api/reports/retrieve.md) e segui le [indicazioni per il nuovo tentativo degli elementi non riusciti](https://docs.didit.me/it/console/export-pdf-csv.md#riprovare-gli-elementi-di-esportazione-non-riusciti). Invia da 1 a 1000 ID di una `SESSION_EXPORT` in stato `READY` o `FAILED`, senza un intervallo di date sostitutivo. Le sessioni eliminate non possono essere sottoposte a nuovo tentativo. ## OpenAPI ````yaml it/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/reports/{report_uuid}/retry/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/reports/{report_uuid}/retry/: post: tags: - Reports summary: Ripeti il tentativo per il report asincrono description: >- Richiede autorizzazioni di lettura per ogni risorsa coperta dal report. Le credenziali di applicazione o chiave API devono appartenere all'applicazione indicata nel percorso. I token Bearer di membro devono avere accesso all'applicazione. Richiede inoltre autorizzazioni di scrittura per le risorse da esportare. Ometti item_ids per eseguire di nuovo l'esportazione originale, eventualmente su un intervallo di date sostitutivo. Un report creato come nuovo tentativo di elementi non riusciti richiede una selezione esplicita di item_ids per ulteriori nuovi tentativi. Con item_ids, solo il richiedente originale (un requested_by_user_id non nullo che corrisponde all'utente autenticato) può ripetere un SESSION_EXPORT in stato READY o FAILED. Una chiave API o un token di applicazione senza tale identità utente riceve 403 per un nuovo tentativo selettivo. Seleziona solo le sessioni non riuscite ancora esistenti dell'esportazione originale: le sessioni eliminate non possono essere esportate di nuovo. Il report originale resta invariato. La prima selezione crea un nuovo report (201); riproporre la stessa selezione restituisce il report di nuovo tentativo già esistente (200). Selezioni sovrapposte o diverse già assegnate a un altro nuovo tentativo restituiscono 400. Vedi [Riprova gli elementi di esportazione non riusciti](https://docs.didit.me/it/console/export-pdf-csv#riprovare-gli-elementi-di-esportazione-non-riusciti). operationId: retry_reports parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: ID dell'organizzazione. - name: application_id in: path required: true schema: type: string format: uuid description: ID dell'applicazione. - name: report_uuid in: path required: true schema: type: string format: uuid description: UUID del report. requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/AsyncReportRetryRequest' example: {} responses: '200': description: >- Replay di una selezione di elementi falliti identica; restituisce il report di nuovo tentativo esistente senza accodarne un altro. content: application/json: schema: $ref: '#/components/schemas/AsyncReport' '201': description: Nuova esportazione accodata. content: application/json: schema: $ref: '#/components/schemas/AsyncReport' '400': description: >- Selezione vuota o non valida, più di 1000 ID, ID non presenti tra le sessioni fallite attive di questo report, esportazione non completata o non basata su sessioni, selezione di nuovo tentativo in conflitto, oppure intervallo di date non valido o misto. '401': description: Credenziali mancanti, non valide o scadute. '403': description: >- Autorizzazioni di lettura/scrittura mancanti oppure nuovo tentativo selettivo effettuato da un utente diverso dal richiedente originale, incluso un chiamante senza identità utente. '404': description: Report non trovato in questa applicazione. '409': description: Il report è in fase di eliminazione; non può essere riprovato. '429': $ref: '#/components/responses/RateLimitedWrite' security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.reports.retry( "11111111-2222-3333-4444-555555555555", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.reports.retry("11111111-2222-3333-4444-555555555555"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Reports.Retry(ctx, \"11111111-2222-3333-4444-555555555555\", didit.AsyncReportRetryRequest{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.AsyncReportRetryRequest; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.reports().retry("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- reports->retry('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.reports.retry("11111111-2222-3333-4444-555555555555") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Reports.RetryAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: AsyncReportRetryRequest: type: object properties: item_ids: type: array description: >- Selezione facoltativa da 1 a 1000 UUID di sessioni live non riuscite di questa esportazione. I duplicati vengono unificati. Solo il richiedente originale può ritentare un sottoinsieme. Non può essere combinata con date_from/date_to. items: type: string format: uuid minItems: 1 maxItems: 1000 date_from: type: string description: >- Data di inizio facoltativa del periodo sostitutivo. Invia entrambe le date in ordine; omettile per un nuovo tentativo sugli elementi non riusciti. format: date date_to: type: string description: >- Data di fine facoltativa del periodo sostitutivo, uguale o successiva a date_from. format: date notify_on_ready: type: boolean description: >- Invia un'email al richiedente quando il report è pronto, se è disponibile un'email del richiedente. default: false AsyncReport: type: object required: - uuid - report_type - report_type_display - status - status_display - parameters - requested_by_user_id - requested_by_email - requested_by_name - row_count - failed_item_ids - failed_count - file_size - files - scheduled_report - error_message - deletion_pending - eta_seconds - started_at - completed_at - expires_at - created_at - updated_at properties: uuid: type: string description: Identificatore del report. format: uuid report_type: type: string description: Tipo di esportazione o di report di conformità. enum: - SESSION_EXPORT - TRANSACTION_EXPORT - BUSINESS_EXPORT - VENDOR_USER_EXPORT - VENDOR_BUSINESS_EXPORT - CASE_EXPORT - CASE_SLA_EXPORT - LIST_ENTRY_EXPORT - EVENT_EXPORT - COMPLIANCE_KYC_KYB - COMPLIANCE_AML_LOG - COMPLIANCE_TRAVEL_RULE - COMPLIANCE_SANCTIONS_PEP - COMPLIANCE_RISK_SUMMARY - COMPLIANCE_SAR_STR_DRAFT - COMPLIANCE_CTR - COMPLIANCE_CASE_SUMMARY report_type_display: type: string description: Etichetta visualizzata per il tipo di report. status: type: string description: >- Stato di generazione. READY può includere singoli errori; controlla failed_count. enum: - PENDING - PROCESSING - READY - FAILED status_display: type: string description: Etichetta visualizzata per lo stato di generazione. parameters: type: object description: >- Opzioni originali dell'esportazione; le chiavi dipendono da report_type. additionalProperties: true requested_by_user_id: type: string description: >- Identità del richiedente originale, oppure null per i chiamanti senza identità utente. format: uuid nullable: true requested_by_email: type: string description: Email del richiedente, quando disponibile. nullable: true requested_by_name: type: string description: Nome visualizzato del richiedente, quando disponibile. nullable: true row_count: type: integer description: Numero di record esportati, oppure null prima della generazione. nullable: true failed_item_ids: type: array description: >- UUID delle sessioni live non riuscite in questa esportazione della verifica. Le sessioni eliminate sono escluse. Usa questi ID per un nuovo tentativo selettivo. items: type: string format: uuid failed_count: type: integer description: Numero di voci in failed_item_ids. minimum: 0 file_size: type: integer description: >- Dimensione totale del file generato in byte, oppure null prima della generazione. format: int64 nullable: true files: type: array description: Metadati del file generato; non contiene URL di download. items: $ref: '#/components/schemas/AsyncReportFile' scheduled_report: type: string description: >- Identificatore della pianificazione, oppure null per un report non pianificato. format: uuid nullable: true error_message: type: string description: Errore di generazione, se disponibile. nullable: true deletion_pending: type: boolean description: Indica se un'eliminazione richiesta è ancora in corso. eta_seconds: type: integer description: >- Secondi stimati al completamento per un report in attesa o in elaborazione; null senza cronologia o quando è completato. nullable: true started_at: type: string description: Data di inizio della generazione. format: date-time nullable: true completed_at: type: string description: Data di completamento della generazione. format: date-time nullable: true expires_at: type: string description: Ora di scadenza del report. format: date-time created_at: type: string description: Data di creazione. format: date-time updated_at: type: string description: Data dell'ultimo aggiornamento. format: date-time example: uuid: 00000000-0000-4000-8000-000000000002 report_type: SESSION_EXPORT report_type_display: Verifications status: READY status_display: Ready parameters: {} requested_by_user_id: null requested_by_email: null requested_by_name: null row_count: 9 failed_item_ids: - 00000000-0000-4000-8000-000000000001 failed_count: 1 file_size: 1200 files: - name: verifications.csv format: csv rows: 9 bytes: 1200 scheduled_report: null error_message: null deletion_pending: false eta_seconds: null started_at: '2026-11-11T01:00:00Z' completed_at: '2026-11-11T01:01:00Z' expires_at: '2026-12-11T01:00:00Z' created_at: '2026-11-11T01:00:00Z' updated_at: '2026-11-11T01:01:00Z' AsyncReportFile: type: object required: - name - format - rows - bytes properties: name: type: string description: Nome del file. format: type: string description: Formato del file. rows: type: integer description: Record esportati in questo file, ove applicabile. nullable: true bytes: type: integer description: Dimensione del file in byte. format: int64 RateLimitBudgetError: type: object description: >- Restituito solo per un rifiuto del budget del middleware del limite di frequenza. Altri errori 429, inclusi i conflitti di idempotenza e i limiti specifici dell'endpoint, non garantiscono questi campi di metadati. required: - detail - reference - limit - remaining - reset - window_seconds properties: detail: type: string description: Messaggio di rifiuto per budget leggibile, già esistente. reference: type: string pattern: ^RL-[0-9a-f]{32}$ description: >- Riferimento di supporto opaco: RL- seguito da 32 caratteri esadecimali minuscoli di un UUID. limit: type: integer description: Budget per l'ambito superato; equivale a X-RateLimit-Limit. remaining: type: integer minimum: 0 description: Budget residuo, limitato a zero; equivale a X-RateLimit-Remaining. reset: type: integer format: int64 description: >- Orario di reset della finestra in secondi Unix; coincide con X-RateLimit-Reset. window_seconds: type: integer description: >- Durata della finestra fissa in secondi, non il tempo di attesa residuo. Rispetta Retry-After prima di riprovare. example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. reference: RL-00000000000040008000000000000001 limit: 300 remaining: 0 reset: 1794358860 window_seconds: 60 responses: RateLimitedWrite: description: >- Il limite di scrittura condiviso di 300 richieste al minuto per chiave API è stato superato. Rispetta `Retry-After` prima di riprovare. content: application/json: schema: $ref: '#/components/schemas/RateLimitBudgetError' example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. reference: RL-00000000000040008000000000000001 limit: 300 remaining: 0 reset: 1794358860 window_seconds: 60 headers: Retry-After: $ref: '#/components/headers/BudgetRetryAfter' X-RateLimit-Scope: $ref: '#/components/headers/BudgetXRateLimitScope' X-RateLimit-Limit: $ref: '#/components/headers/BudgetXRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/BudgetXRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/BudgetXRateLimitReset' headers: BudgetRetryAfter: description: >- Secondi di attesa, arrotondati alla finestra successiva. Presente nei rifiuti per budget del middleware. schema: type: integer BudgetXRateLimitScope: description: >- L'ambito il cui budget è stato superato. Presente nei rifiuti per budget del middleware. schema: type: string BudgetXRateLimitLimit: description: >- Budget per l'ambito superato; equivale al limite nel corpo. Presente nei rifiuti per budget del middleware. schema: type: integer BudgetXRateLimitRemaining: description: >- Budget residuo, limitato a zero; equivale a remaining nel corpo. Presente nei rifiuti per budget del middleware. schema: type: integer BudgetXRateLimitReset: description: >- Orario di reset in secondi Unix; coincide con il reset nel corpo. Presente nei rifiuti per budget del middleware. schema: type: integer securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: Il token di accesso client-credentials dell'applicazione. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.