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

Parámetros de la acción

Envía parameters como un objeto JSON. Los campos obligatorios se marcan como obligatorio.

• width — integer; mínimo 1.
• merge — boolean.
curl --location 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'file=@"/path_to_file/image.jpg"' \ --form 'actionName="JpgToPdf"' \ --form 'parameters="[[\"width\", [\"600\"]],[\"merge\", [\"0\"]]]"' \ --form 'fileUrl=""' \ --form 'fileContent=""' \ --form 'async="true"'
Puedes cambiar el parámetro width sustituyendo 600 por el ancho que quieras.
Si tu archivo está disponible mediante una URL, puedes omitir el campo « file=@.. » y usar directamente su URL en « 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": "JpgToPdf", "slug": "convert-jpg-image-to-pdf-document", "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": "JpgToPdf", "slug": "convert-jpg-image-to-pdf-document", "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": "JpgToPdf", "slug": "convert-jpg-image-to-pdf-document", "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 : JpgToPdf