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

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



## OpenAPI

````yaml it/api-reference/api-swagger-dev-documentation.json POST /api/classification_video/{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_video/{hash}/override:
    post:
      tags:
        - Classification
      summary: Override della classificazione di un video
      description: >-
        Invia un override per la classificazione di un video. Il parametro hash
        identifica in modo univoco il file video inviato. Se lo stesso video
        (quindi lo stesso hash) viene caricato più volte, l'override viene
        applicato a tutti gli invii con questo hash.
      parameters:
        - name: hash
          in: path
          required: true
          schema:
            type: string
          description: L'hash del video.
      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: Override creato.
          content:
            application/json:
              schema:
                type: object
                properties:
                  classification:
                    type: string
                    enum:
                      - human
                      - artificial
                    description: La classificazione dell'override.
                  type:
                    type: string
                    enum:
                      - video
                    description: Il tipo di contenuto.
                  hash:
                    type: string
                    description: L'hash del video.
                required:
                  - classification
                  - type
                  - hash
              example:
                classification: artificial
                type: video
                hash: >-
                  1122bc922b7381529013a2198b9143c0b6a52669fd511cfb030418209f1751a6
        '400':
          description: >-
            Override già inviato, nessuna richiesta associata a questo hash,
            contenuto non ancora classificato, override non più accettato,
            nessuna richiesta completata per questo video 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 video was not classified yet.
                no_longer_possible:
                  summary: Override non più accettato
                  value:
                    error: Is no longer possible to send a report for this video.
                no_completed_request:
                  summary: Nessuna richiesta completata per questo video
                  value:
                    error: No completed request for this video exists.
        '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.