---
title: "Agentes e impresoras"
description: "Conecta ordenadores, descubre colas de impresión y elige una impresora estable para cada flujo."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/es/docs/">Documentación de CloudPrint</a><span aria-hidden="true">/</span><span>Integración API</span></nav>

# Agentes e impresoras

<p class="docs-lead">El agente representa un ordenador y cada impresora representa una cola disponible en ese ordenador.</p>

## Conecta el ordenador

Instala el agente desde la cuenta correcta y completa la conexión. Comprueba su estado y versión antes de diagnosticar una impresora.

## Guarda el identificador

Muestra el nombre al usuario, pero guarda `printer_id`. El nombre de la cola puede cambiar y no es una clave fiable para el enrutamiento.

## Comprueba capacidades

Antes de ofrecer color, dúplex, tamaños, DPI o RAW, compara las opciones solicitadas con las capacidades comunicadas por la impresora.

## Lista de comprobación para producción

- Usa una conexión saliente del agente y no expongas puertos de impresora.
- Guarda el identificador estable de la impresora, no solo su nombre.
- Valida el formato, el tamaño de página y la orientación antes de crear el trabajo.
- Define los estados finales, los reintentos y la protección contra impresiones duplicadas.

## Siguientes pasos

<div class="docs-card-grid"><a class="docs-card" href="/es/docs/api/authentication/"><strong>Autenticación del servidor</strong><span>Intercambia credenciales de API por un token OAuth2 de corta duración mediante Client Credentials.</span></a>
<a class="docs-card" href="/es/docs/api/documents/"><strong>Preparar documentos</strong><span>Sube un PDF listo para imprimir o datos RAW explícitos antes de crear un trabajo.</span></a>
<a class="docs-card" href="/es/docs/troubleshooting/"><strong>Solución de problemas</strong><span>Diagnostica trabajos fallidos sin provocar una segunda impresión por accidente.</span></a></div>

<nav class="docs-resource-links" aria-label="Siguientes pasos"><a href="/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></nav>