> ## 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.

# Ottieni i risultati dell'analisi dei ticket

> Recupera i risultati del rilevamento delle manomissioni del batch indicato.



## OpenAPI

````yaml it/api-v2/api-swagger-v2.json GET /api/v2/tampering/tickets/{batch_id}
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/{batch_id}:
    get:
      tags:
        - Tampering Detection
      summary: Ottieni i risultati dell'analisi dei ticket
      description: >-
        Recupera i risultati del rilevamento delle manomissioni del batch
        indicato.
      parameters:
        - name: batch_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            L'identificativo del batch di cui recuperare i risultati
            dell'analisi di manomissione
      responses:
        '200':
          description: Risultati dell'analisi recuperati
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResultsResponse'
              example:
                identifier: 674a3c9b8e2d4f12b7c9a8d3
                done: false
                total_results: 2
                results:
                  - identifier: 674a3c9b8e2d4f12b7c9a8d4
                    ref_id: TICKET-001
                    status: done
                    hash: >-
                      862bb7de43b131a38b64753269d643443a21069a04ab66a56c9818956f590cb9
                    name: ticket_001.jpg
                    verdict:
                      confidence: 1
                      classification: tampered
                    verdicts:
                      - heuristic: heuristic_name_1
                        description: Human readable description of the heuristic_name_1
                        classification: tampered
                      - heuristic: heuristic_name_2
                        description: Human readable description of the heuristic_name_2
                        classification: tampered
                      - heuristic: heuristic_name_3
                        description: Human readable description of the heuristic_name_3
                        classification: tampered
                      - heuristic: heuristic_name_4
                        description: Human readable description of the heuristic_name_4
                        classification: authentic
                    results:
                      - model: Ellen
                        unknown: false
                        elapsed_time: 0.1473182961344719
                        classification:
                          - label: human
                            score: 0.15
                          - label: artificial
                            score: 0.85
                        classification_details:
                          confidence: 0.85
                          performance:
                            - name: classification
                              value: 0.1473182961344719
                    c2pa: null
                  - identifier: 674a3c9b8e2d4f12b7c9a8d5
                    ref_id: TICKET-002
                    status: inprogress
        '400':
          description: Richiesta non valida - Identificativi non validi
          content:
            application/json:
              example:
                error: Invalid request
                message: identifiers array cannot be empty
        '401':
          description: API key non valida o mancante
          content:
            application/json:
              example:
                error: Unauthorized
                message: Invalid or missing API key
        '404':
          description: Uno o più identificativi non trovati
          content:
            application/json:
              example:
                error: Not found
                message: Batch not found
                batch_id: 674a3c9b8e2d4f12b7c9a8d9
      security:
        - ApiKeyAuth: []
components:
  schemas:
    BatchResultsResponse:
      type: object
      properties:
        identifier:
          type: string
          description: Identificativo del batch di questa analisi
        done:
          type: boolean
          description: Indica se tutte le analisi del batch sono completate
        total_results:
          type: integer
          description: Numero totale di risultati restituiti
        results:
          type: array
          description: Array dei risultati dell'analisi di manomissione
          items:
            $ref: '#/components/schemas/TamperingResult'
    TamperingResult:
      type: object
      properties:
        identifier:
          type: string
          description: Identificativo interno dell'analisi
        ref_id:
          type: string
          description: ID di riferimento associato a questo ticket
        status:
          type: string
          enum:
            - new
            - inprogress
            - done
            - errored
          description: Stato attuale dell'analisi
        hash:
          type: string
          description: Hash SHA-256 dell'immagine (solo se completata)
        name:
          type: string
          description: Nome del file originale del ticket (solo se completata)
        verdict:
          $ref: '#/components/schemas/OverallTamperingVerdict'
          description: >-
            Verdetto principale del rilevamento delle manomissioni (solo se
            completata)
        verdicts:
          type: array
          description: Tutti i verdetti delle diverse euristiche (solo se completata)
          items:
            $ref: '#/components/schemas/TamperingVerdict'
        results:
          type: array
          description: Risultati dettagliati di ogni modello (solo se completata)
          items:
            $ref: '#/components/schemas/ModelResult'
        c2pa:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/C2PA'
          description: >-
            Informazioni della Coalition for Content Provenance and Authenticity
            che certificano l'origine e la storia del contenuto multimediale.
            Contiene i manifest, i risultati della validazione e le informazioni
            sulla firma. Null se l'immagine non contiene metadati C2PA.
      required:
        - identifier
        - status
    OverallTamperingVerdict:
      type: object
      properties:
        confidence:
          type: number
          format: float
          description: Punteggio di affidabilità tra 0 e 1
        classification:
          type: string
          enum:
            - authentic
            - tampered
          description: 'Risultato della classificazione: authentic o tampered'
    TamperingVerdict:
      type: object
      properties:
        heuristic:
          type: string
          description: Nome dell'euristica o dell'algoritmo usato
        description:
          type: string
          description: Descrizione dell'euristica o dell'algoritmo
        classification:
          type: string
          enum:
            - authentic
            - tampered
          description: 'Risultato della classificazione: authentic o tampered'
    ModelResult:
      type: object
      properties:
        model:
          type: string
          description: Nome del modello usato
        unknown:
          type: boolean
          description: Indica se il risultato è incerto
        elapsed_time:
          type: number
          format: float
          description: Tempo impiegato per la classificazione, in secondi
        classification:
          type: array
          description: Punteggi di classificazione per ogni etichetta
          items:
            $ref: '#/components/schemas/ClassificationScore'
        classification_details:
          type: object
          description: Dettagli aggiuntivi della classificazione
          properties:
            confidence:
              type: number
              format: float
            performance:
              type: array
              items:
                type: object
                properties:
                  name:
                    type: string
                  value:
                    type: number
    C2PA:
      type: object
      properties:
        manifests:
          type: object
          description: >-
            Dizionario dei manifest C2PA, indicizzati per URN del manifest. Ogni
            manifest contiene informazioni sulla storia della creazione e delle
            modifiche del contenuto.
          additionalProperties:
            type: object
            properties:
              label:
                type: string
                description: Identificativo URN di questo manifest
              title:
                type: string
                description: Titolo leggibile del manifest
              assertions:
                type: array
                description: Elenco delle asserzioni crittografiche sul contenuto
                items:
                  type: object
                  properties:
                    label:
                      type: string
                      description: Tipo di asserzione (ad es. 'c2pa.actions.v2')
                    data:
                      type: object
                      description: Contenuto dei dati dell'asserzione
              ingredients:
                type: array
                description: >-
                  Elenco dei materiali di origine usati per creare questo
                  contenuto
                items:
                  type: object
                  properties:
                    label:
                      type: string
                      description: Tipo di ingrediente
                    title:
                      type: string
                      description: Nome dell'ingrediente
                    format:
                      type: string
                      description: Formato del file dell'ingrediente
                    relationship:
                      type: string
                      description: Relazione con il contenuto padre (ad es. 'componentOf')
                    active_manifest:
                      type: string
                      description: URN del manifest attivo dell'ingrediente
                    validation_results:
                      type: object
                      description: Risultati della validazione di questo ingrediente
              instance_id:
                type: string
                description: ID dell'istanza XMP
              signature_info:
                type: object
                description: Informazioni sulla firma crittografica
                properties:
                  alg:
                    type: string
                    description: Algoritmo di firma usato (ad es. 'Es256')
                  issuer:
                    type: string
                    description: Emittente del certificato
                  common_name:
                    type: string
                    description: Common name del certificato
                  cert_serial_number:
                    type: string
                    description: Numero di serie del certificato
              claim_generator_info:
                type: array
                description: Informazioni sul software che ha generato la claim
                items:
                  type: object
                  properties:
                    name:
                      type: string
                      description: Nome del software generatore della claim
        active_manifest:
          type: string
          description: URN del manifest attualmente attivo
        validation_state:
          type: string
          enum:
            - Valid
            - Invalid
            - Unknown
          description: Stato complessivo della validazione dei dati C2PA
        validation_status:
          type: array
          description: Elenco dei messaggi sullo stato della validazione
          items:
            type: object
            properties:
              url:
                type: string
                description: URN o URL dell'elemento validato
              code:
                type: string
                description: Codice dello stato della validazione
              explanation:
                type: string
                description: Spiegazione leggibile del risultato della validazione
        validation_results:
          type: object
          description: Risultati dettagliati della validazione
          properties:
            activeManifest:
              type: object
              properties:
                failure:
                  type: array
                  description: Elenco delle validazioni non riuscite
                  items:
                    type: object
                success:
                  type: array
                  description: Elenco delle validazioni riuscite
                  items:
                    type: object
                informational:
                  type: array
                  description: Messaggi informativi della validazione
                  items:
                    type: object
            ingredientDeltas:
              type: array
              description: Differenze di validazione degli ingredienti
              items:
                type: object
    ClassificationScore:
      type: object
      properties:
        label:
          type: string
          description: Etichetta di classificazione
        score:
          type: number
          format: float
          description: Punteggio di questa etichetta tra 0 e 1
  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.