Programadores
API de conversão de ficheiros para caixas, documentos e discos
Uma API REST em /api/v1 para espaços Business: catálogo, jobs, envios, descargas e webhooks. Autenticação com uma chave da organização.
O que é a API
A versão 1 vive em /api/v1. Autentique-se com Authorization: Bearer e uma chave da organização com prefixo mdn_. O documento OpenAPI é público em /api/v1/openapi, sem chave. Os motores não devem indexar /api/.
Recursos
Liste as conversões do mesmo catálogo do produto. Crie jobs, envie ficheiros, siga o estado, descarregue resultados e subscreva webhooks. As chaves de idempotência evitam duplicar trabalho ao repetir.
Automatização
O contrato destina-se a Zapier, Make, n8n, MCP e scripts internos — as mesmas operações de um clique no espaço Business. Páginas /integrations/n8n virão quando esses conectores forem um produto, não uma frase.
O que não é
Não há uma API anónima de conversão no domínio de marketing. A conversão de convidado fica no uploader do sítio. As chaves pertencem a uma organização; uma chave divulgada é um incidente de espaço.
Correio e discos
Numa migração, as operações úteis são pares de correio e discos de hipervisor, não JPG para PNG. Comece pelo catálogo filtrado por família e anexe ficheiros como na interface.