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
curl --location 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'file=@"/FILE_PATH/FILE_NAME"' \ --form 'actionName="SplitPdf"' \ --form 'parameters=[]' \ --form 'async="true"' \ --form 'fileUrl=""' \ --form 'fileContent=""'
Si tu archivo está disponible por URL, ignora el campo « file=@.. » y usa directamente su URL en el campo « fileUrl ».

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": "SplitPdf", "slug": "split-pdf-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": "SplitPdf", "slug": "split-pdf-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": "SplitPdf", "slug": "split-pdf-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 : SplitPdf