Saltar al contenido principal
TransConvert

Document Conversion API

Convert PDF, Word, PowerPoint, Excel, and OpenDocument files with one POST request — including turning a PDF back into an editable DOCX or XLSX.

POST https://transconvert.com/api/v1/convert.php

Parámetros

Field Description
AuthorizationRequired. "Bearer tc_live_...".
categorySet to "document".
targetRequired. Output format code, e.g. "PDF", "DOCX", "XLSX".
fileRequired. The document to convert.

Ejemplos

TransConvert
curl -X POST \
  https://transconvert.com/api/v1/convert.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=document" \
  -F "target=PDF" \
  -F "file=@report.docx" \
  -o output.pdf

Respuesta

En caso de éxito (200): los bytes en bruto del archivo convertido, con las cabeceras Content-Type y Content-Disposition configuradas para él. En caso de error: un cuerpo JSON con la forma {"error": {"code": "...", "message": "..."}} y un código de estado HTTP correspondiente; consulta Errores más abajo.

Header Value
Content-TypeEl tipo MIME real del archivo convertido (p. ej. image/png, application/pdf).
Content-Dispositionattachment; filename="..." — un nombre de archivo sugerido, igual que en cualquier descarga.
Content-LengthTamaño del cuerpo de la respuesta en bytes.

Todos los errores siguen la misma estructura JSON; por ejemplo, al superar una cuota:

429 Too Many Requests
{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly API allowance of 5000 conversion-minutes reached.",
    "limit": 5000,
    "used": 5000
  }
}

Errores

Cada error devuelve un JSON con un "code" sobre el que tu código puede ramificarse, además de un "message" legible por humanos. Algunos errores incluyen campos adicionales (quota_exceeded incluye, por ejemplo, "limit" y "used").

Status & code When it happens
401 missing_keyNo se envió ninguna cabecera Authorization.
401 invalid_keyLa clave no existe, o ha sido revocada.
403 account_suspendedLa cuenta propietaria de esta clave está suspendida.
403 plan_requiredLa cuenta está en el plan Free: el acceso a la API requiere Basic, Lite, Pro o Team.
400 invalid_category"category" no era "image" ni "document".
400 missing_target"target" estaba vacío.
400 no_fileNo se envió ningún archivo, o la subida falló; el campo debe llamarse "file".
413 file_too_largeEl archivo supera el tamaño máximo de subida permitido por tu plan.
429 quota_exceededSe agotó la asignación mensual de minutos de conversión del plan. Se restablece al inicio del siguiente mes natural.
429 concurrency_limitYa hay demasiadas conversiones en curso a la vez para esta cuenta (se comparte con el sitio web); espera a que termine una y vuelve a intentarlo.
422 conversion_failedEl propio archivo no se pudo convertir; "message" explica el motivo. El código de estado varía según la causa: 400/415/422 significan que el archivo o el destino no funcionarán por más intentos que hagas; 500/503 indican un problema del lado del servidor, y en concreto 503 merece un breve reintento.

Supported formats

Aceptados como origen:

PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, RTF, ODT, ODP, ODS, HTML

Disponibles como destino:

PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, RTF, ODT, ODP, ODS

Relacionado