Documentación API

Integre una potente conversión de archivos en su aplicación con nuestra API RESTful

EmpezarkeyObtener clave API
bolt

Rayo rápido

Conversión de alto rendimiento con procesamiento optimizado

shield

Seguro y confiable

Seguridad de nivel empresarial con un tiempo de actividad del 99,9 %

trending_up

Escalable

Del prototipo a la producción, escalamos contigo

terminalEmpezando

Para utilizar la API de 1converter, siga estos sencillos pasos:

  1. Regístrese para obtener una cuenta gratuita en 1converter.com
  2. Genere una clave API desde su panel de control
  3. Comience a realizar solicitudes API con su clave API

keyAutenticación

Todas las solicitudes de API deben incluir su clave API en el encabezado de Autorización:

X-API-Key: YOUR_API_KEY Authorization: Bearer YOUR_API_KEY

Nota: Nunca comparta su clave API ni la envíe al control de versiones.

Mantenga su clave API segura y nunca la exponga en el código del lado del cliente.

URL base

Todas las solicitudes de API deben realizarse a:

https://api.1-converter.com/api/v1

OpenAPI 3.1 specification (JSON)

codePuntos finales API

Cargar y convertir

Cargue un archivo y conviértalo al formato especificado

POST/api/v1/convert/upload

Encabezados de solicitud

Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

Cuerpo de la solicitud

  • el archivo a convertir (obligatorio)
  • formato de destino (por ejemplo, 'pdf', 'jpg', 'png') (obligatorio)

Respuesta

{
  "id": 4821,
  "original_file_name": "document.pdf",
  "original_format": "pdf",
  "target_format": "docx",
  "status": "pending",
  "progress": 0,
  "created_at": "2026-08-01T09:14:03Z",
  "expires_at": "2026-08-08T09:14:03Z"
}

Verificar estado

Comprobar el estado de una conversión

GET/api/v1/convert/status/:id

Respuesta

{
  "conversion": {
    "id": 4821,
    "original_file_name": "document.pdf",
    "target_format": "docx",
    "status": "completed",
    "progress": 100,
    "created_at": "2026-08-01T09:14:03Z",
    "expires_at": "2026-08-08T09:14:03Z"
  }
}

Descargar resultado

Descargue el archivo convertido

GET/api/v1/convert/download/:id

Límites de tarifas

Las solicitudes a la API están limitadas por minuto. Se requiere un plan de pago para acceder a la API:

PlanLímite de tarifa
GratisNo disponible: requiere actualización
Motor de arranque5000 solicitudes/minuto
Pro5000 solicitudes/minuto
NegocioIlimitado

Cuando se excedan los límites de tarifas, recibirá una respuesta 429 Demasiadas solicitudes.

Códigos de error

La API utiliza códigos de estado HTTP estándar para indicar éxito o fracaso:

CódigoDescripción
400 Solicitud incorrectaParámetros de solicitud no válidos
401 No autorizadoClave API no válida o faltante
403 ProhibidoPermisos insuficientes
404 no encontradoRecurso no encontrado
429 Demasiadas solicitudesLímite de tarifa excedido
500 Error interno del servidorError del servidor, inténtelo de nuevo

integration_instructionsEjemplos de código

A continuación se muestran ejemplos en diferentes lenguajes de programación:

JavaScript (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');

axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
 headers: {
 ...formData.getHeaders(),
 'Authorization': 'Bearer YOUR_API_KEY'
 }
}).then(response => {
 console.log(response.data);
}).catch(error => {
 console.error(error);
});

Pitón

import requests

url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

rizo

curl -X POST https://api.1-converter.com/api/v1/convert/upload \
 -H "X-API-Key: YOUR_API_KEY" \
 -F "[email protected]" \
 -F "target_format=png"

¿Necesitar ayuda?

Si tiene preguntas o necesita ayuda con la API, ¡estamos aquí para ayudarlo!

support_agentContactar con soportekeyAdministrar claves API