---
title: "Aktuellen API-Client-Kontext abrufen"
description: "Prüfen Sie, welches CloudPrint-Konto, welche Client-Anwendung und welche Scopes das aktuelle Zugriffstoken repräsentiert."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Aktuellen API-Client-Kontext abrufen

<p class="docs-lead">Prüfen Sie, welches CloudPrint-Konto, welche Client-Anwendung und welche Scopes das aktuelle Zugriffstoken repräsentiert.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-get">GET</span><code>/api/v1/me</code><span><strong>API-Version:</strong> v1</span><span><strong>operationId:</strong> <code>getApiClientContext</code></span><a href="/de/docs/api/v1/authentication/client-context/index.md">Als Markdown anzeigen</a></div>

## 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.

## Verwandte Dokumentation

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/v1/authentication/token/"><strong>OAuth2-Zugriffstoken abrufen</strong><span>Tauschen Sie CloudPrint-API-Zugangsdaten per Client Credentials gegen ein kurzlebiges OAuth2-Bearer-Token.</span></a>
<a class="docs-card" href="/de/docs/api/v1/agents/list/"><strong>Verbundene Agents auflisten</strong><span>Rufen Sie die CloudPrint Agents des Kontos ab und prüfen Sie Verbindung, Version und verfügbares Update.</span></a>
<a class="docs-card" href="/de/docs/api/v1/printers/list/"><strong>Verfügbare Drucker auflisten</strong><span>Rufen Sie die über verbundene Agents sichtbaren Drucker ab und wählen Sie eine stabile Drucker-ID für Ihre Integration.</span></a></div>

<nav class="docs-resource-links" aria-label="Nächste Schritte"><a href="https://cloudprint.me/status/">Dienststatus</a><a href="/de/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Konto öffnen</a><a href="/docs/legal/privacy/">Datenschutzerklärung</a><a href="/docs/legal/terms/">Nutzungsbedingungen</a><a href="/docs/legal/payments-and-refunds/">Zahlungen und Erstattungen</a><a href="/docs/legal/data-processing/">DPA</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>