Obtener el contexto actual del cliente API
Confirma qué cuenta, aplicación cliente y permisos representa el token de acceso actual.
Qué hace este método
Confirma qué cuenta, aplicación cliente y permisos representa el token de acceso actual.
Autenticación
Envía un token de corta duración en Authorization: Bearer <access_token>.
Se acepta cualquier token de acceso válido de CloudPrint; no se necesitan permisos adicionales.
Solicitud
URL de producción: https://public-api.cloudprint.me/api/v1/me
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/api/v1/me \
-H "Authorization: Bearer $ACCESS_TOKEN"Respuesta
Estado HTTP: 200 — Solicitud completada.
Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción | Restricciones |
|---|---|---|---|---|
account_id | string (uuid) | sí | UUID estable de la cuenta CloudPrint propietaria del recurso. | — |
account_name | string | sí | Nombre legible de la cuenta CloudPrint. | example: "Acme Print Ops" |
client_app_id | string | null (uuid) | sí | Identificador estable de las credenciales API representadas por el token actual. | — |
client_app_name | string | null | sí | Nombre de las credenciales API usado para diagnosticar la cuenta. | — |
application_id | string | null (uuid) | no | Identificador estable de la Developer Application asociada al recurso. | — |
application_name | string | null | no | Nombre de la Developer Application que ven los operadores de la cuenta. | — |
authorization_mode | string | sí | Modelo de autorización del token: credenciales de cuenta o App Installation. | enum: client_credentials |
installation_id | string | null (uuid) | sí | UUID estable de la App Installation asociada al recurso. | — |
scopes | array | sí | Permisos concedidos al token de acceso actual. | example: ["agents:read","printers:read","documents:write","print_jobs:write","print_jobs:read"] |
permissions | array | no | Permisos aprobados para la App Installation. | — |
Ejemplo de respuesta
json
{
"account_id": "11111111-1111-4111-8111-111111111111",
"account_name": "Acme Print Ops",
"authorization_mode": "client_credentials",
"installation_id": "11111111-1111-4111-8111-111111111111",
"client_app_id": "11111111-1111-4111-8111-111111111111",
"client_app_name": "string",
"scopes": [
"agents:read",
"printers:read",
"documents:write",
"print_jobs:write",
"print_jobs:read"
]
}Errores
| Estado HTTP | Descripción |
|---|---|
401 | Falta la autenticación o no es válida. |
429 | Se superó el límite de solicitudes; respeta Retry-After. |
500 | Error interno de CloudPrint. |
Recomendaciones de integración
- Úsalo durante la incorporación y el diagnóstico para verificar la cuenta y los permisos.
- No lo llames antes de cada operación: el token ya representa el contexto.
Documentación relacionada
Obtener un token de acceso OAuth2Intercambia las credenciales de la API de CloudPrint por un token Bearer OAuth2 de corta duración mediante Client Credentials.Listar agentes de impresión conectadosConsulta los agentes CloudPrint de la cuenta y revisa su conexión, versión y estado de actualización.Listar impresoras disponiblesConsulta las impresoras visibles mediante agentes conectados y elige un ID de impresora estable para la integración.