Listar cuentas de clientes gestionadas
Consulta las cuentas creadas por la Developer Application autenticada, incluido el estado de agentes e impresoras.
GET
/partner-api/v1/accountsVersión de la API: v1operationId: listPartnerManagedAccountsVer como MarkdownQué hace este método
Consulta las cuentas creadas por la Developer Application autenticada, incluido el estado de agentes e impresoras.
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
Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Descripción | Restricciones |
|---|---|---|---|---|---|
limit | query | integer | no | Número máximo de recursos que se devuelven en una página. | min: 1; max: 100; default: 50 |
cursor | query | string (uuid) | no | Cursor opaco de la página solicitada; envíalo de nuevo sin modificarlo. | — |
external_customer_id | query | string | no | Identificador estable del cliente en el sistema del integrador. Debe ser único dentro de la Developer Application autenticada. | minLength: 1; maxLength: 160 |
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 \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Respuesta
Estado HTTP: 200 — Solicitud completada.
Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción | Restricciones |
|---|---|---|---|---|
data | array | sí | Recursos devueltos en la página actual de resultados. | — |
next_cursor | string | null (uuid) | sí | Cursor opaco de la página siguiente; envíalo de nuevo sin modificarlo. | — |
Ejemplo de respuesta
json
{
"data": [
{
"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"
}
],
"next_cursor": "11111111-1111-4111-8111-111111111111"
}Errores
| Estado HTTP | Descripción |
|---|---|
401 | Falta la autenticación o no es válida. |
403 | El token no tiene permisos suficientes. |
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
Crear una cuenta de cliente gestionadaCrea una cuenta CloudPrint aislada, una App Installation y un Agent Enrollment de un solo uso sin registro del cliente.Obtener una cuenta de cliente gestionadaRecupera directamente un cliente gestionado mediante el ID estable de la relación.Cuentas administradas en CloudPrint Developer PlatformCrea y administra cuentas de CloudPrint aisladas para tus clientes desde tu propio producto.