Obtener una cuenta de cliente gestionada

Recupera directamente un cliente gestionado mediante el ID estable de la relación.

GET/partner-api/v1/accounts/{relationshipId}Versión de la API: v1operationId: getPartnerManagedAccountVer como Markdown

Qué hace este método

Recupera directamente un cliente gestionado mediante el ID estable de la relación.

Autenticación

Envía una aserción RS256 de un solo uso de la Developer Application en Authorization: Bearer <application_assertion>. No es un token de acceso de Public API.

Solicitud

URL de producción: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}

Parámetros

Nombre	Ubicación	Tipo	Obligatorio	Descripción	Restricciones
`relationshipId`	path	`string (uuid)`	sí	UUID estable de la relación del partner con el cliente gestionado.	—
`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/partner-api/v1/accounts/$RELATIONSHIP_ID" \
  -H "Authorization: Bearer $APPLICATION_ASSERTION"

Respuesta

Estado HTTP: 200 — Solicitud completada.

Campos de respuesta

Nombre	Tipo	Obligatorio	Descripción	Restricciones
`relationship_id`	`string (uuid)`	sí	UUID estable de la relación entre el partner y el cliente gestionado.	—
`developer_account_id`	`string (uuid)`	sí	UUID estable de la cuenta de desarrollador propietaria de la relación.	—
`cloudprint_account_id`	`string (uuid)`	sí	UUID estable de la cuenta CloudPrint creada para el cliente gestionado.	—
`external_customer_id`	`string`	sí	Identificador estable que el integrador asigna al cliente en su propio sistema.	maxLength: 160
`name`	`string`	sí	Nombre legible del recurso que ven los operadores de la cuenta.	maxLength: 120
`application_id`	`string (uuid)`	sí	Identificador estable de la Developer Application asociada al recurso.	—
`installation_id`	`string \| null (uuid)`	sí	UUID estable de la App Installation asociada al recurso.	—
`agent_enrollment_id`	`string \| null (uuid)`	sí	Identificador estable del Agent Enrollment.	—
`agent_onboarding_expires_at`	`string \| null (date-time)`	sí	Marca de tiempo ISO 8601 registrada por CloudPrint.	—
`agent_onboarding_url`	`string \| null (uri)`	sí	Enlace canónico de un solo uso para conectar un agente. Ábrelo completo, sin modificarlo, y no lo guardes en los registros.	example: `"https://connect.cloudprint.me/setup#token=cpat_example"`
`onboarding_status`	`string`	sí	Estado actual de preparación de CloudPrint para el cliente gestionado.	enum: `provisioning`, `waiting_for_agent`, `ready`, `failed`
`status`	`string`	sí	Estado actual del recurso o flujo; usa los valores enum específicos del método.	enum: `provisioning`, `active`, `suspended`, `closed`
`created_at`	`string (date-time)`	sí	Marca de tiempo ISO 8601 registrada por CloudPrint.	—
`updated_at`	`string (date-time)`	sí	Marca de tiempo ISO 8601 registrada por CloudPrint.	—
`health`	`object`	sí	Resumen del estado de los agentes y las impresoras del cliente gestionado.	—

Ejemplo de respuesta

json

{
  "health": {
    "agent_count": 0,
    "online_agent_count": 0,
    "printer_count": 0,
    "online_printer_count": 0,
    "last_seen_at": "2026-08-06T12:00:00Z"
  },
  "relationship_id": "11111111-1111-4111-8111-111111111111",
  "developer_account_id": "11111111-1111-4111-8111-111111111111",
  "cloudprint_account_id": "11111111-1111-4111-8111-111111111111",
  "external_customer_id": "string",
  "name": "string",
  "application_id": "11111111-1111-4111-8111-111111111111",
  "installation_id": "11111111-1111-4111-8111-111111111111",
  "agent_enrollment_id": "11111111-1111-4111-8111-111111111111",
  "agent_onboarding_expires_at": "2026-08-06T12:00:00Z",
  "agent_onboarding_url": "https://connect.cloudprint.me/setup#token=cpat_example",
  "onboarding_status": "provisioning",
  "status": "provisioning",
  "created_at": "2026-08-06T12:00:00Z",
  "updated_at": "2026-08-06T12:00:00Z"
}

Errores

Estado HTTP	Descripción
`401`	Falta la autenticación o no es válida.
`403`	El token no tiene permisos suficientes.
`404`	No se encontró el recurso.
`422`	Uno o varios campos no son válidos.
`429`	Se superó el límite de solicitudes; respeta Retry-After.
`500`	Error interno de CloudPrint.

Documentación relacionada

Listar cuentas de clientes gestionadasConsulta las cuentas creadas por la aplicación del partner autenticada, incluido el estado de agentes e impresoras.Crear y administrar cuentas de clientesAprovisiona cuentas administradas y controla su ciclo de vida desde Partner API.Listar agentes de un cliente gestionadoConsulta todos los agentes conectados a un cliente gestionado, incluidos los revocados.

Obtener una cuenta de cliente gestionada ​

Qué hace este método ​

Autenticación ​

Solicitud ​

Parámetros ​

Cuerpo de la solicitud ​

Ejemplos de solicitud ​

cURL ​

Respuesta ​

Campos de respuesta ​

Ejemplo de respuesta ​

Errores ​

Documentación relacionada ​