> ## Documentation Index
> Fetch the complete documentation index at: https://docs.identifai.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Invia i ticket per l'analisi

> Invia un batch di immagini di ticket per il rilevamento delle **manomissioni**. Ogni ticket può avere un ID esterno, restituito nella risposta per semplificarne il tracciamento.



## OpenAPI

````yaml it/api-v2/api-swagger-v2.json POST /api/v2/tampering/tickets
openapi: 3.0.0
info:
  title: API v2 di identifAI
  version: 2.0.0
  description: >-
    API v2 per il rilevamento delle manomissioni in batch su immagini di ticket.
    Questa API permette di inviare più ticket per l'analisi e di recuperare i
    risultati del rilevamento delle manomissioni.
servers:
  - url: https://api.identifai.net
security: []
tags:
  - name: Tampering Detection
    description: Endpoint per il rilevamento delle manomissioni in batch
paths:
  /api/v2/tampering/tickets:
    post:
      tags:
        - Tampering Detection
      summary: Invia i ticket per l'analisi
      description: >-
        Invia un batch di immagini di ticket per il rilevamento delle
        **manomissioni**. Ogni ticket può avere un ID esterno, restituito nella
        risposta per semplificarne il tracciamento.
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                tickets:
                  type: array
                  items:
                    type: string
                    format: binary
                  description: Array dei file dei ticket (immagini o PDF) da analizzare
                ref_ids:
                  type: string
                  description: >-
                    Stringa con un elenco di ref_id separati da virgole. Se
                    indicato, il numero di elementi deve corrispondere alla
                    lunghezza dell'array dei ticket.
                  example: Ticket-1, Ticket-2, Ticket-3
                models:
                  type: string
                  description: >-
                    Stringa facoltativa con i nomi dei modelli, separati da
                    virgole, da usare per il rilevamento delle manomissioni. Se
                    non indicata, vengono usati tutti i modelli disponibili per
                    il tuo piano. Se vuota, non viene eseguita alcuna
                    classificazione.
                  example: Model-1, Model-2, Model-3
              required:
                - tickets
      responses:
        '200':
          description: >-
            Invio del batch riuscito. Restituisce l'elenco degli identificativi
            delle analisi.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchSubmissionResponse'
              example:
                batch_id: 674a3c9b8e2d4f12b7c9a8d3
                total_tickets: 3
                submissions:
                  - identifier: 674a3c9b8e2d4f12b7c9a8d4
                    ref_id: Ticket-001
                  - identifier: 674a3c9b8e2d4f12b7c9a8d5
                    ref_id: Ticket-002
                  - identifier: 674a3c9b8e2d4f12b7c9a8d6
                    ref_id: Ticket-003
        '400':
          description: Richiesta non valida - Parametri di input non validi
          content:
            application/json:
              example:
                error: Invalid request
                message: The number of ref_ids must match the number of tickets
        '401':
          description: API key non valida o mancante
          content:
            application/json:
              example:
                error: Unauthorized
                message: Invalid or missing API key
        '413':
          description: Payload troppo grande - La dimensione del batch supera il limite
          content:
            application/json:
              example:
                error: Payload too large
                message: Maximum batch size is 10 tickets
      security:
        - ApiKeyAuth: []
components:
  schemas:
    BatchSubmissionResponse:
      type: object
      properties:
        batch_id:
          type: string
          description: Identificativo univoco di questo invio in batch
        total_tickets:
          type: integer
          description: Numero totale di ticket inviati in questo batch
        submissions:
          type: array
          description: >-
            Elenco degli identificativi degli invii di immagini creati. L'elenco
            può essere più lungo del numero di ticket se da un singolo ticket
            sono state estratte più immagini (ad es. un file PDF). In questo
            caso più invii fanno riferimento allo stesso ref_id.
          items:
            $ref: '#/components/schemas/AnalysisIdentifier'
    AnalysisIdentifier:
      type: object
      properties:
        identifier:
          type: string
          description: Identificativo interno dell'analisi
        ref_id:
          type: string
          description: ID di riferimento indicato al momento dell'invio (se presente)
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.