Aktuellen API-Client-Kontext abrufen

Prüfen Sie, welches CloudPrint-Konto, welche Client-Anwendung und welche Scopes das aktuelle Zugriffstoken repräsentiert.

GET/api/v1/meAPI-Version: v1operationId: getApiClientContextAls Markdown anzeigen

Funktion dieser Methode

Prüfen Sie, welches CloudPrint-Konto, welche Client-Anwendung und welche Scopes das aktuelle Zugriffstoken repräsentiert.

Authentifizierung

Senden Sie ein kurzlebiges Token in Authorization: Bearer <access_token>.

Jedes gültige CloudPrint-Zugriffstoken wird akzeptiert; kein zusätzlicher Scope ist erforderlich.

Anfrage

Produktions-URL: https://public-api.cloudprint.me/api/v1/me

Parameter

Name	Position	Typ	Erforderlich	Beschreibung	Einschränkungen
`X-Request-Id`	header	`string`	nein	Optionale Kennung zur Anfrageverfolgung; CloudPrint gibt einen sicheren Wert im Antwort-Header zurück.	maxLength: 128; example: `"order-100045-attempt-1"`

Anfrageinhalt

Die Methode hat keinen Anfrageinhalt.

Anfragebeispiele

cURL

bash

curl -sS https://public-api.cloudprint.me/api/v1/me \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Antwort

HTTP-Status: 200 — Anfrage erfolgreich.

Antwortfelder

Name	Typ	Erforderlich	Beschreibung	Einschränkungen
`account_id`	`string (uuid)`	ja	Stabile UUID des CloudPrint-Kontos, dem die Ressource gehört.	—
`account_name`	`string`	ja	Anzeigename des CloudPrint-Kontos.	example: `"Acme Print Ops"`
`client_app_id`	`string \| null (uuid)`	ja	Stabile Kennung der API-Zugangsdaten, die das aktuelle Token repräsentiert.	—
`client_app_name`	`string \| null`	ja	Name der API-Zugangsdaten für die Kontodiagnose.	—
`application_id`	`string \| null (uuid)`	nein	Stabile Kennung der Developer Application, die mit der Ressource verknüpft ist.	—
`application_name`	`string \| null`	nein	Name der Developer Application, den die Kontobetreiber sehen.	—
`authorization_mode`	`string`	ja	Autorisierungsmodell des Tokens: Kontozugangsdaten oder App Installation.	enum: `client_credentials`
`installation_id`	`string \| null (uuid)`	ja	Stabile UUID der App Installation, die mit der Ressource verknüpft ist.	—
`scopes`	`array`	ja	Scopes, die dem aktuellen Zugriffstoken erteilt wurden.	example: `["agents:read","printers:read","documents:write","print_jobs:write","print_jobs:read"]`
`permissions`	`array`	nein	Für die App Installation genehmigte Berechtigungen.	—

Beispielantwort

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"
  ]
}

Fehler

HTTP-Status	Beschreibung
`401`	Authentifizierung fehlt oder ist ungültig.
`429`	Anfragelimit überschritten; beachten Sie Retry-After.
`500`	Interner CloudPrint-Fehler.

Hinweise zur Integration

Nutzen Sie die Methode beim Onboarding und zur Prüfung von Konto und Scopes.
Rufen Sie sie nicht vor jeder API-Anfrage auf; das Token enthält den Kontext bereits.

Aktuellen API-Client-Kontext abrufen ​

Funktion dieser Methode ​

Authentifizierung ​

Anfrage ​

Parameter ​

Anfrageinhalt ​

Anfragebeispiele ​

cURL ​

Antwort ​

Antwortfelder ​

Beispielantwort ​

Fehler ​

Hinweise zur Integration ​

Verwandte Dokumentation ​