API

Elaborazione metadati via HTTP

Lo stesso motore che alimenta il sito web, disponibile come API versionata. Invia file multipart, ricevi JSON o il file elaborato.

Leggi la documentazione Ottieni una chiave API

Endpoint disponibili

POST/api/v1/analyzeLegge ogni campo di metadati presente nel file.
POST/api/v1/cleanRimuove i metadati e verifica il risultato ottenuto.
POST/api/v1/editScrive o elimina singoli campi di metadati.
POST/api/v1/apply-profileApplica un profilo metadati dispositivo coerente.

Descrizione leggibile da macchine: /api/v1/openapi.json

Una prima richiesta di esempio

curl -X POST https://your-domain/api/v1/clean \
  -H "Authorization: Bearer nmd_live_..." \
  -F "file=@photo.jpg" \
  -F "mode=full" \
  -F "response=json"

{
  "verified": true,
  "before": { "fields": 31, "removable": 26, "gps": true },
  "after":  { "fields": 5,  "removable": 0,  "gps": false },
  "removed": [ { "key": "camera.make", "label": "Make" } ],
  "notes": [ "The compressed image data was copied unchanged." ]
}

Accesso e volumi

L’accesso alle API è incluso a partire dal piano Pro. Ciascuna chiave scala le chiamate dalla quota mensile prevista dal tuo piano, e ogni risposta indica nei suoi header la quota rimanente per consentirti di rallentare prima di ricevere rifiuti.

Quote API per piano
Piano	Chiamate al mese	Chiavi	Dimensione massima file
Pro	2000	3	4.29 MB
Business	50.000	20	4.29 MB
Enterprise	Su misura	Personalizzato	4.29 MB

Consulta i prezzi per il confronto completo, oppure contattaci per volumi enterprise superiori.

Domande frequenti

Conservate i file che invio all’API?

No. Un file esiste nella memoria del processo che gestisce la singola richiesta e viene rilasciato con la risposta. Nulla viene scritto su disco, quindi non ci sono file temporanei da ripulire né finestre di conservazione di cui doversi fidare.

Come avviene l’autenticazione all’API?

Tramite una chiave API, inviata come "Authorization: Bearer <key>" o come header "X-API-Key: <key>". Le chiavi vengono mostrate solo una volta al momento della creazione e memorizzate unicamente sotto forma di hash SHA-256, rendendo inutile qualsiasi fuga del database.

Cosa succede se supero la mia quota?

Ricevi uno stato HTTP 429 con un codice interpretabile da programma, i conteggi utilizzati e consentiti e un header Retry-After. Ogni risposta andata a buon fine include anche X-RateLimit-Remaining, permettendo al tuo client di rallentare prima di superare il limite.

L’API è versionata?

Sì. Tutti gli endpoint pubblici risiedono sotto /api/v1/ e la struttura delle risposte non subirà modifiche impreviste. Le rotte /api/ non versionate sono interne all’applicazione web e non offrono garanzie di compatibilità: non utilizzarle per le tue integrazioni.

Quali formati sono supportati dall’API?

L’API supporta tutti i formati letti dal motore, elencati per intero nella pagina dei formati: immagini, video, audio e PDF. Pulizia e modifica funzionano su tutti tranne WebM, che può essere pulito ma non modificato. Un’operazione non supportata restituisce 422 anziché ignorare la richiesta in silenzio.