Referencia de la API v1 de CloudPrint
Integra CloudPrint con una referencia versionada sobre autenticación, impresoras, documentos, trabajos de impresión, errores y reintentos.
Cómo usar esta documentación
El inicio rápido explica el flujo completo; la referencia de la API v1 detalla solicitudes, campos, respuestas y errores. Todas las operaciones están disponibles en HTML y Markdown.
URL base y flujo
Envía las solicitudes de producción a https://public-api.cloudprint.me: obtén un token, selecciona una impresora, sube el documento, crea un trabajo idempotente y consulta su estado final.
Compatibilidad
La versión principal forma parte de la ruta. En v1 pueden aparecer ampliaciones compatibles; eliminar o renombrar operaciones o campos requiere una versión principal nueva.
Alcance de CloudPrint
CloudPrint envía PDF listos para imprimir o datos RAW en un lenguaje de impresora definido a impresoras locales mediante la conexión saliente del agente. Public API no genera etiquetas de transportista ni convierte documentos Office.
Todas las operaciones de la API v1
| Tipo | Descripción | Ruta |
|---|---|---|
POST | Token de acceso | /oauth/token |
POST | Token de instalación | /developer-api/v1/app-installations/{installationId}/access-tokens |
GET | Versiones del agente | /agent-download-api/v1/releases |
GET | Descargar el instalador | /agent-download-api/v1/installers/{filename} |
GET | Cuentas gestionadas | /partner-api/v1/accounts |
POST | Crear cuenta gestionada | /partner-api/v1/accounts |
GET | Obtener cuenta gestionada | /partner-api/v1/accounts/{relationshipId} |
GET | Listar Agent Enrollments | /partner-api/v1/accounts/{relationshipId}/agent-enrollments |
POST | Crear Agent Enrollment | /partner-api/v1/accounts/{relationshipId}/agent-enrollments |
GET | Obtener Agent Enrollment | /partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId} |
DELETE | Revocar Agent Enrollment | /partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId} |
GET | Agentes gestionados | /partner-api/v1/accounts/{relationshipId}/agents |
DELETE | Revocar agente | /partner-api/v1/accounts/{relationshipId}/agents/{agentId} |
GET | Uso del partner | /partner-api/v1/usage |
POST | Cambiar estado de cuenta | /partner-api/v1/accounts/{relationshipId}/{action} |
GET | Contexto del cliente | /api/v1/me |
GET | Listar agentes | /api/v1/agents |
GET | Listar impresoras | /api/v1/printers |
POST | Subir documento | /api/v1/documents |
GET | Listar trabajos | /api/v1/print-jobs |
POST | Crear trabajo | /api/v1/print-jobs |
POST | Crear desde URL | /api/v1/print-jobs/from-url |
POST | Crear desde Base64 | /api/v1/print-jobs/from-base64 |
GET | Estado del trabajo | /api/v1/print-jobs/{printJobId} |