API

Procesamiento de metadatos vía HTTP

El mismo motor que impulsa la aplicación web, disponible como API versionada. Envía archivos multipart y recibe JSON estructurado o el archivo procesado.

Leer la documentación Obtener una clave de API

Endpoints disponibles

POST/api/v1/analyzeLee cada campo de metadatos presente en el archivo.
POST/api/v1/cleanElimina metadatos y verifica el resultado obtenido.
POST/api/v1/editEscribe o elimina campos individuales de metadatos.
POST/api/v1/apply-profileAplica un perfil de metadatos de dispositivo coherente.

Descripción OpenAPI procesable por máquinas: /api/v1/openapi.json

Petición de ejemplo inicial

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." ]
}

Acceso y volumen

El acceso a la API está disponible a partir del plan Pro. Cada clave descuenta peticiones de la cuota mensual de tu plan, y cada respuesta indica en sus cabeceras la cuota restante para que puedas ralentizar antes de recibir rechazos.

Cuotas de API por plan
Plan	Llamadas por mes	Claves	Tamaño máximo de archivo
Pro	2000	3	4.29 MB
Business	50.000	20	4.29 MB
Enterprise	A medida	Personalizado	4.29 MB

Consulta los precios para la comparativa completa, o contáctanos para volúmenes enterprise mayores.

Preguntas frecuentes

¿Almacenáis los archivos enviados a la API?

No. El archivo existe en la memoria del proceso que gestiona la petición concreta y se libera de inmediato con la respuesta. Nada se escribe en disco, por lo que no hay archivos temporales que limpiar ni ventanas de retención de las que preocuparse.

¿Cómo funciona la autenticación en la API?

Mediante una clave de API, enviada en la cabecera "Authorization: Bearer <key>" o como "X-API-Key: <key>". Las claves se muestran solo una vez tras su creación y se almacenan únicamente como hash criptográfico SHA-256.

¿Qué ocurre si supero mi cuota mensual?

Recibes una respuesta HTTP 429 con un código legible por máquina, los contadores de uso y una cabecera Retry-After. Las respuestas correctas incluyen X-RateLimit-Remaining para prever el agotamiento de la cuota.

¿La API está versionada?

Sí. Todos los endpoints públicos operan bajo /api/v1/ y la estructura de respuesta es estable y predecible.

¿Qué formatos admite la API?

Todos los formatos admitidos por el motor: imágenes, video, audio y PDF. Las operaciones no implementadas para un formato devuelven 422 en lugar de fallar en silencio.