Sviluppatori
API di conversione file per cassette, documenti e dischi
Un’API REST in /api/v1 per spazi Business: catalogo, job, upload, download e webhook. Autenticazione con una chiave dell’organizzazione.
Cos’è l’API
La versione 1 vive in /api/v1. Autenticazione con Authorization: Bearer e una chiave organizzazione con prefisso mdn_. Il documento OpenAPI è pubblico su /api/v1/openapi, senza chiave. I motori non devono indicizzare /api/.
Risorse
Elencate le conversioni dallo stesso catalogo del prodotto. Create job, caricate file, seguite lo stato, scaricate i risultati e sottoscrivete webhook. Le chiavi di idempotenza evitano duplicati al retry.
Automazione
Il contratto è pensato per Zapier, Make, n8n, MCP e script interni — le stesse operazioni di un clic nello spazio Business. Pagine /integrations/n8n arriveranno quando quei connettori saranno un prodotto, non una frase.
Cosa non è
Non c’è un’API anonima di conversione sul dominio marketing. L’ospite resta sull’uploader del sito. Le chiavi sono di un’organizzazione; una chiave trapelata è un incidente di spazio.
Posta e dischi
Per una migrazione contano le coppie mailbox e i dischi hypervisor, non JPG in PNG. Partite dal catalogo filtrato per famiglia e allegate i file come nell’interfaccia.