Esta API es fácil de usar. Solo tienes que seguir estos pasos

• Crear una cuenta gratis
• Haz clic en el enlace que recibas por correo para confirmar tu dirección.
• Generar un token con credenciales

Puedes usar cualquier lenguaje para realizar esta llamada CURL. (Python, PHP, Java, JavaScript...) ¿Necesitas ayuda?

curl --location --request POST 'https://mxprocess.com/api/login_check' \ --header 'Content-Type: application/json' \ --data-raw '{"username":"YOUR_LOGIN","password":"YOUR_PASSWORD"}'

Si tus credenciales son correctas, nuestro servidor te proporcionará un token como respuesta: {"token": "YOUR_TOKEN","refresh_token": "YOUR_REFRESH_TOKEN"}
YOUR_TOKEN es válido durante una hora; su duración puede ampliarse usando YOUR_REFRESH_TOKEN.


• Usa el token para iniciar el proceso de forma asíncrona
Descargando resultados: Cuando está presente en una respuesta de la API, actionResultsDownloadURLs contiene las URL autenticadas para descargar cada archivo de resultado generado.



API asíncrona: concatenación de vídeos

Envía de 2 a 15 vídeos como file0 a file14, o URL públicas separadas por | en fileUrl. Puedes combinar subidas y URL. Cada entrada está limitada a 100 MB y 10 minutos; el conjunto completo, a 1 GB y 30 minutos.

Punto de acceso: POST https://mxprocess.com/api/files/start-process
Autenticación: Bearer JWT
Coste: 15 tokens, cobrados solo tras finalizar correctamente.

Subir archivos

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'actionName=VideoConcat' \ --form 'file0=@/path/to/first.mp4' \ --form 'file1=@/path/to/second.mov' \ --form 'parameters=[]' \ --form 'async=true'

URL públicas

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'actionName=VideoConcat' \ --form 'fileUrl=https://example.com/first.mp4|https://example.com/second.webm' \ --form 'parameters=[]' \ --form 'async=true'

Guarda el ID de acción devuelto y consulta /api/actions/get-action-infos/{id} con el mismo JWT. Al terminar, actionResults contiene un archivo autenticado descargable llamado video-concat.mp4.

Respuesta inicial

{"id":123,"action":{"actionName":"VideoConcat","slug":"concat-video-online"},"accomplished":false,"actionResults":[],"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

La cardinalidad, la propiedad, el MIME/contenido, el tamaño y la duración se rechazan antes del procesamiento con un error estable VIDEO_CONCAT_*.

Contáctenos


La API envía una respuesta JSON para confirmar que el proceso ha comenzado. Anota el campo « trackingUrl », que permite seguir el proceso iniciado. La respuesta también contiene su ID; en este ejemplo es 643: { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "trackingUrl": "https://mxprocess.com/api/actions/get-action-infos/643" }


• Para seguir el progreso, realiza una solicitud GET sencilla (puedes hacer esta llamada HTTP cada 10 segundos):
curl --location 'https://mxprocess.com/api/actions/get-action-infos/643' \ --header 'Authorization: Bearer YOUR_TOKEN' }}

Si el proceso aún no ha terminado, recibirás este tipo de respuesta con "accomplished": false { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": null, "endTime": null, "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

Si el proceso ha terminado, recibirás este tipo de respuesta con "accomplished": true. El campo actionResultsDownloadURLs contiene las URL autenticadas para descargar los resultados generados: { "actionResultsDownloadURLs": [ "https://mxprocess.com/api/actions/download-result/643/35084b44a841ec597be3048df44145e8.txt.log/YOUR_TOKEN" ], "id": 643, "actionParameters": { "commandParameters": "" }, "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": "2024-01-28T11:24:49+01:00", "endTime": "2024-01-28T11:25:09+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": true, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [ [ "35084b44a841ec597be3048df44145e8.txt.log" ] ], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

Usa directamente cada URL proporcionada en actionResultsDownloadURLs para descargar el resultado correspondiente.

¿La documentación no es clara? (Python, PHP, Java, JavaScript...) ¿Necesitas ayuda?

Contáctenos Esta API también está disponible en modo síncrono: API para desarrolladores : VideoConcat