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

# Override della classificazione di un'immagine

> Invia un override per la classificazione di un'immagine. Il parametro hash identifica in modo univoco il file immagine inviato. Se la stessa immagine (quindi lo stesso hash) viene caricata più volte, l'override viene applicato a tutti gli invii con questo hash.

**Nota:** questo endpoint è disponibile anche con l'alias `/api/classification_image/{hash}/override`.



## OpenAPI

````yaml it/api-reference/api-swagger-dev-documentation.json POST /api/classification/{hash}/override
openapi: 3.0.0
info:
  title: API di identifAI
  version: 1.0.0
  description: >-
    API per integrare le funzionalità di classificazione di immagini e video di
    identifAI.<br><details><summary>**Come ottenere la tua API
    key**</summary>Per ottenere la tua API key, segui questi semplici
    passaggi:   <ol><li><p>**Crea un profilo utente e accedi alla
    piattaforma**</p>Se non hai ancora un account, visita la nostra piattaforma
    e crea un profilo utente. Dopo aver completato la registrazione e verificato
    la tua e-mail, accedi con le tue credenziali.</li><li><p>**Apri il menu
    utente**</p>Dopo l'accesso, fai clic sul tuo nome o sull'icona utente in
    alto a destra nello schermo.</li><li><p>**Seleziona la voce API key**</p>Nel
    menu a tendina che compare, seleziona la voce "Api-Key". Da lì puoi
    visualizzare o generare la tua API key.</li></ol>Ora sei pronto per usare la
    tua API key con la nostra API!</details><details><summary>**Come usare
    l'API**</summary>Per usare l'API, effettua prima una richiesta **POST** per
    avviare la classificazione. Poi usa l'***identificativo*** restituito dalla
    richiesta **POST** per recuperare i risultati.

    <details>

    <summary>**1. Classificazione delle immagini**</summary>
      * Per classificare un'immagine, effettua una richiesta **POST** a `/api/classification` con i parametri richiesti (per i dettagli sui parametri consulta la sezione *"Classificazione"* qui sotto).
      * Nella risposta riceverai l'***identificativo*** dell'immagine classificata.
      * Usa l'***identificativo*** ricevuto per recuperare i risultati della classificazione con una richiesta **GET** a `/api/classification/{identifier}` (per i dettagli su come strutturare la richiesta consulta la sezione *"Classificazione"* qui sotto).
      * La risposta contiene i risultati della classificazione dell'immagine in formato JSON.<br>Nella risposta trovi un array ***results***, con i risultati della classificazione di ogni modello usato, e un array ***verdicts***, con i risultati di ogni euristica applicata.<br>Se la classificazione non è ancora completa, continua a inviare la richiesta **GET** finché il risultato non è disponibile.</details><details><summary>**2. Classificazione dei video**</summary>
        * Per classificare un video, effettua una richiesta **POST** a `/api/classification_video` con i parametri richiesti (per i dettagli sui parametri consulta la sezione *"Classificazione"* qui sotto).
        * Nella risposta riceverai l'***identificativo*** del video classificato.
        * Usa l'***identificativo*** ricevuto per recuperare i risultati della classificazione con una richiesta **GET** a `/api/classification_video/{identifier}` (per i dettagli su come strutturare la richiesta consulta la sezione *"Classificazione"* qui sotto).
        * La risposta contiene i risultati della classificazione del video in formato JSON. Per la classificazione, il video viene suddiviso in *frame*.<br> Nella risposta trovi un array ***results***, con l'esito della classificazione di ogni modello applicato a ogni frame analizzato, e un array ***verdicts***, con i risultati di ogni euristica usata.<br> Se la classificazione non è completa, continua a inviare la richiesta **GET** finché non vengono restituiti i risultati finali.</details><details><summary>**3. Tutte le classificazioni**</summary>L'endpoint `/api/classifications` restituisce tutte le classificazioni di immagini effettuate da un utente, con i risultati di tutte le richieste di classificazione di immagini passate.</details><details><summary>**4. Gestione degli utenti**</summary>  L'endpoint **POST** `/api/user` permette di creare un utente, mentre l'endpoint **DELETE** `/api/user` serve a eliminare un utente (per la struttura delle richieste consulta la sezione sugli utenti qui sotto).</details></details>
servers:
  - url: https://backend.identifai.net
security: []
tags:
  - name: Classification
    description: Route di classificazione
  - name: Infrastructure
    description: Route dell'infrastruttura
  - name: User
    description: Azioni dell'utente
  - name: Partner
    description: Azioni dei partner
paths:
  /api/classification/{hash}/override:
    post:
      tags:
        - Classification
      summary: Override della classificazione di un'immagine
      description: >-
        Invia un override per la classificazione di un'immagine. Il parametro
        hash identifica in modo univoco il file immagine inviato. Se la stessa
        immagine (quindi lo stesso hash) viene caricata più volte, l'override
        viene applicato a tutti gli invii con questo hash.


        **Nota:** questo endpoint è disponibile anche con l'alias
        `/api/classification_image/{hash}/override`.
      parameters:
        - name: hash
          in: path
          required: true
          schema:
            type: string
          description: L'hash dell'immagine.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                classification:
                  type: string
                  enum:
                    - human
                    - artificial
                  description: La classificazione corretta.
              required:
                - classification
      responses:
        '201':
          description: Segnalazione creata.
          content:
            application/json:
              schema:
                type: object
                properties:
                  classification:
                    type: string
                    enum:
                      - human
                      - artificial
                    description: La classificazione segnalata.
                  type:
                    type: string
                    enum:
                      - image
                    description: Il tipo di contenuto.
                  hash:
                    type: string
                    description: L'hash dell'immagine.
                required:
                  - classification
                  - type
                  - hash
              example:
                classification: human
                type: image
                hash: >-
                  862bb7de43b131a38b64753269d643443a21069a04ab66a56c9818956f590cb9
        '400':
          description: >-
            Override già inviato, nessuna richiesta associata a questo hash,
            contenuto non ancora classificato, override non più accettato o
            errori di validazione.
          content:
            application/json:
              examples:
                validation_required:
                  summary: Il campo classificazione è obbligatorio
                  value:
                    classification:
                      - The classification field is required.
                validation_invalid:
                  summary: Valore di classificazione non valido
                  value:
                    classification:
                      - The selected classification is invalid.
                no_request:
                  summary: Nessuna richiesta associata a questo hash
                  value:
                    error: You haven't got any request for this content.
                already_submitted:
                  summary: Override già inviato
                  value:
                    error: You have already submitted a report for this content.
                not_classified:
                  summary: Contenuto non ancora classificato
                  value:
                    error: This image was not classified yet.
                no_longer_possible:
                  summary: Override non più accettato
                  value:
                    error: Is no longer possible to send a report for this image.
        '401':
          description: API key non valida o mancante.
          content:
            application/json:
              example:
                error: Unauthorized
        '403':
          description: >-
            L'utente non è autorizzato ad accedere a questa API o non ha
            accettato i Termini di servizio.
          content:
            application/json:
              example:
                error: Forbidden
        '429':
          description: Troppe richieste.
          content:
            application/json:
              example:
                error: Too Many Attempts.
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: X-Api-Key
      in: header
      description: La tua API key.

````

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