Listar versiones públicas de CloudPrint Agent
Consulta los instaladores actuales de CloudPrint Agent y sus sumas de comprobación sin credenciales de CloudPrint.
GET
/agent-download-api/v1/releasesVersión de la API: v1operationId: listPublicAgentReleasesVer como MarkdownQué hace este método
Consulta los instaladores actuales de CloudPrint Agent y sus sumas de comprobación sin credenciales de CloudPrint.
Autenticación
Este método no requiere un token Bearer.
Solicitud
URL de producción: https://public-api.cloudprint.me/agent-download-api/v1/releases
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Descripción | Restricciones |
|---|---|---|---|---|---|
X-Request-Id | header | string | no | Identificador opcional para rastrear la solicitud; CloudPrint devuelve un valor seguro en la cabecera de respuesta. | maxLength: 128; example: "order-100045-attempt-1" |
Cuerpo de la solicitud
El método no tiene cuerpo de solicitud.
Ejemplos de solicitud
cURL
bash
curl -sS https://public-api.cloudprint.me/agent-download-api/v1/releasesRespuesta
Estado HTTP: 200 — Solicitud completada.
Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción | Restricciones |
|---|---|---|---|---|
available | boolean | sí | Indica si hay un instalador publicado para la plataforma solicitada. | — |
channel | string | null | sí | Canal de publicación al que pertenece esta versión del agente. | — |
releases | array | sí | Instaladores del agente publicados, agrupados por plataforma compatible. | — |
unavailable_reason | string | null | no | Motivo por el que no hay un instalador publicado para esta plataforma. | — |
Ejemplo de respuesta
json
{
"available": true,
"channel": "string",
"releases": [
{
"version": "string",
"channel": "string",
"published_at": "2026-08-06T12:00:00Z",
"installers": [
{
"filename": "string",
"platform": "macos",
"architecture": "string",
"format": "string",
"size_bytes": 1,
"sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"download_url": "/resource"
}
]
}
]
}Errores
| Estado HTTP | Descripción |
|---|---|
429 | Se superó el límite de solicitudes; respeta Retry-After. |
500 | Error interno de CloudPrint. |
503 | Servicio temporalmente no disponible. |
Documentación relacionada
Descargar un instalador de CloudPrint AgentDescarga un instalador publicado usando el nombre de archivo exacto que devuelve el catálogo de versiones.Conectar un agente de clienteVincula CloudPrint Agent con la cuenta administrada correcta sin iniciar sesión en el panel del cliente.Agentes e impresorasConecta ordenadores, descubre colas de impresión y elige una impresora estable para cada flujo.