---
title: "Referencia de la API v1 de CloudPrint"
description: "Integra CloudPrint con una referencia versionada sobre autenticación, impresoras, documentos, trabajos de impresión, errores y reintentos."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/es/docs/">Documentación de CloudPrint</a><span aria-hidden="true">/</span><span>Referencia de la API</span></nav>

# Referencia de la API v1 de CloudPrint

<p class="docs-lead">Integra CloudPrint con una referencia versionada sobre autenticación, impresoras, documentos, trabajos de impresión, errores y reintentos.</p>

<div class="api-reference-actions"><span><strong>Versión de la API:</strong> v1</span><a href="/docs/api/v1/openapi.json">Descargar OpenAPI v1 en JSON</a><a href="/es/docs/api/v1/explorer/">Abrir el explorador interactivo de la API</a><a href="/es/docs/api/v1/index.md">Ver como Markdown</a></div>

## 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](/es/docs/api/v1/authentication/token/) | `/oauth/token` |
| `POST` | [Token de instalación](/es/docs/api/v1/app-installations/access-token/) | `/developer-api/v1/app-installations/{installationId}/access-tokens` |
| `GET` | [Versiones del agente](/es/docs/api/v1/agent-downloads/releases/) | `/agent-download-api/v1/releases` |
| `GET` | [Descargar el instalador](/es/docs/api/v1/agent-downloads/installer/) | `/agent-download-api/v1/installers/{filename}` |
| `GET` | [Cuentas gestionadas](/es/docs/api/v1/partner/accounts/list/) | `/partner-api/v1/accounts` |
| `POST` | [Crear cuenta gestionada](/es/docs/api/v1/partner/accounts/create/) | `/partner-api/v1/accounts` |
| `GET` | [Obtener cuenta gestionada](/es/docs/api/v1/partner/accounts/get/) | `/partner-api/v1/accounts/{relationshipId}` |
| `GET` | [Listar Agent Enrollments](/es/docs/api/v1/partner/agent-enrollments/list/) | `/partner-api/v1/accounts/{relationshipId}/agent-enrollments` |
| `POST` | [Crear Agent Enrollment](/es/docs/api/v1/partner/agent-enrollments/create/) | `/partner-api/v1/accounts/{relationshipId}/agent-enrollments` |
| `GET` | [Obtener Agent Enrollment](/es/docs/api/v1/partner/agent-enrollments/get/) | `/partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}` |
| `DELETE` | [Revocar Agent Enrollment](/es/docs/api/v1/partner/agent-enrollments/revoke/) | `/partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}` |
| `GET` | [Agentes gestionados](/es/docs/api/v1/partner/agents/list/) | `/partner-api/v1/accounts/{relationshipId}/agents` |
| `DELETE` | [Revocar agente](/es/docs/api/v1/partner/agents/revoke/) | `/partner-api/v1/accounts/{relationshipId}/agents/{agentId}` |
| `GET` | [Uso del partner](/es/docs/api/v1/partner/usage/) | `/partner-api/v1/usage` |
| `POST` | [Cambiar estado de cuenta](/es/docs/api/v1/partner/accounts/change-state/) | `/partner-api/v1/accounts/{relationshipId}/{action}` |
| `GET` | [Contexto del cliente](/es/docs/api/v1/authentication/client-context/) | `/api/v1/me` |
| `GET` | [Listar agentes](/es/docs/api/v1/agents/list/) | `/api/v1/agents` |
| `GET` | [Listar impresoras](/es/docs/api/v1/printers/list/) | `/api/v1/printers` |
| `POST` | [Subir documento](/es/docs/api/v1/documents/upload/) | `/api/v1/documents` |
| `GET` | [Listar trabajos](/es/docs/api/v1/print-jobs/list/) | `/api/v1/print-jobs` |
| `POST` | [Crear trabajo](/es/docs/api/v1/print-jobs/create/) | `/api/v1/print-jobs` |
| `POST` | [Crear desde URL](/es/docs/api/v1/print-jobs/create-from-url/) | `/api/v1/print-jobs/from-url` |
| `POST` | [Crear desde Base64](/es/docs/api/v1/print-jobs/create-from-base64/) | `/api/v1/print-jobs/from-base64` |
| `GET` | [Estado del trabajo](/es/docs/api/v1/print-jobs/get/) | `/api/v1/print-jobs/{printJobId}` |

## Documentación relacionada

<div class="docs-card-grid"><a class="docs-card" href="/es/docs/api/v1/authentication/token/"><strong>Obtener un token de acceso OAuth2</strong><span>Intercambia las credenciales de la API de CloudPrint por un token Bearer OAuth2 de corta duración mediante Client Credentials.</span></a>
<a class="docs-card" href="/es/docs/api/v1/printers/list/"><strong>Listar impresoras disponibles</strong><span>Consulta las impresoras visibles mediante agentes conectados y elige un ID de impresora estable para la integración.</span></a>
<a class="docs-card" href="/es/docs/api/v1/print-jobs/create/"><strong>Crear un trabajo de impresión</strong><span>Envía un documento subido a una impresora seleccionada con idempotencia y opciones de impresión explícitas.</span></a></div>

<nav class="docs-resource-links" aria-label="Siguientes pasos"><a href="https://cloudprint.me/status/">Estado del servicio</a><a href="/es/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Abrir cuenta</a><a href="/docs/legal/privacy/">Política de privacidad</a><a href="/docs/legal/terms/">Términos de uso</a><a href="/docs/legal/payments-and-refunds/">Pagos y reembolsos</a><a href="/docs/legal/data-processing/">Tratamiento de datos</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>