API para desarrolladores
Llama a las herramientas desde tu propio software sin navegador: envía una solicitud, inicia un trabajo y descarga el resultado. Todos los endpoints residen en una única dirección versionada; cada solicitud se autoriza con una clave personal.
Flujo de trabajo
Una llamada inicia un trabajo de conversión y te devuelve un ID de trabajo. Con ese ID consultas el estado y descargas el resultado una vez completado. Los trabajos pueden tardar un poco, por lo que esta separación permite a los clientes esperar sin bloquear su flujo.
Clave y acceso
Las solicitudes se firman con el encabezado Authorization: Bearer. Crea tu clave en tu cuenta y revócala cuando quieras; la clave en texto sin formato solo se muestra al momento de crearla. Una sesión de navegador no cuenta como autenticación aquí.
Herramientas con API abierta
| Herramienta | Superficie de la API | Documento |
|---|---|---|
| ImagenMini | Convertidor — POST /run | Documento |
| Libro de Ingresos y Gastos | 10 endpoints (app con estado) | Documento |
| PdfSplit | Convertidor — POST /run | Documento |
Versiones y contrato
Los endpoints están versionados bajo https://api.pixepi.com con /api/v1; cualquier cambio incompatible requiere una nueva versión. El contrato legible por máquina se publica como OpenAPI 3.1 y puede integrarse directamente en generadores de clientes.
Respuestas y errores
Las respuestas vienen en un formato JSON; cada trabajo se consulta por su propio ID y la pertenencia del registro se comprueba en el servidor. Si algo sale mal, la respuesta devuelve un código que describe el estado; el cliente traduce ese código a su propio idioma.
Más detalles
- El enlace de API en la página de la herramienta que elijas; abre sus endpoints, campos de solicitud, opciones y gestión de errores.
- Contrato legible por máquina: documento OpenAPI.
- Página central para desarrolladores: la lista compartida de todos los endpoints.