Pobierz kontekst klienta API
Sprawdź, do którego konta i aplikacji API należy bieżący token oraz jakie ma uprawnienia.
Działanie metody
Sprawdź, do którego konta i aplikacji API należy bieżący token oraz jakie ma uprawnienia.
Uwierzytelnianie
Przekaż krótkotrwały token w Authorization: Bearer <access_token>.
Wystarczy dowolny ważny token dostępu CloudPrint; dodatkowe uprawnienia nie są wymagane.
Żądanie
Podstawowy adres API: https://public-api.cloudprint.me/api/v1/me
Parametry
| Nazwa | Położenie | Typ | Wymagane | Opis | Ograniczenia |
|---|---|---|---|---|---|
X-Request-Id | header | string | nie | Opcjonalny identyfikator do śledzenia żądania; CloudPrint zwróci bezpieczną wartość w nagłówku odpowiedzi. | maxLength: 128; example: "order-100045-attempt-1" |
Treść żądania
Metoda nie ma treści żądania.
Przykładowe żądania
cURL
bash
curl -sS https://public-api.cloudprint.me/api/v1/me \
-H "Authorization: Bearer $ACCESS_TOKEN"Odpowiedź
Status HTTP: 200 — Żądanie zostało wykonane.
Pola odpowiedzi
| Nazwa | Typ | Wymagane | Opis | Ograniczenia |
|---|---|---|---|---|
account_id | string (uuid) | tak | Stabilny UUID konta CloudPrint, do którego należy zasób. | — |
account_name | string | tak | Czytelna nazwa konta CloudPrint. | example: "Acme Print Ops" |
client_app_id | string | null (uuid) | tak | Stabilny identyfikator danych API reprezentowanych przez bieżący token. | — |
client_app_name | string | null | tak | Nazwa danych API używana w diagnostyce konta. | — |
application_id | string | null (uuid) | nie | Stabilny identyfikator Developer Application reprezentowanej przez token instalacji. | — |
application_name | string | null | nie | Nazwa Developer Application widoczna dla operatorów konta. | — |
authorization_mode | string | tak | Model autoryzacji tokenu: dane konta albo instalacja aplikacji. | enum: client_credentials |
installation_id | string | null (uuid) | tak | Stabilny UUID App Installation, która autoryzowała token. | — |
scopes | array | tak | Uprawnienia przyznane bieżącemu tokenowi dostępu. | example: ["agents:read","printers:read","documents:write","print_jobs:write","print_jobs:read"] |
permissions | array | nie | Uprawnienia instalacji zawarte w tym tokenie. | — |
Przykładowa odpowiedź
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"
]
}Błędy
| Status HTTP | Opis |
|---|---|
401 | Brak uwierzytelnienia albo jest ono nieprawidłowe. |
429 | Przekroczono limit żądań; zastosuj Retry-After. |
500 | Wewnętrzny błąd CloudPrint. |
Wskazówki integracyjne
- Używaj tego sprawdzenia podczas konfiguracji i diagnostyki konta oraz przyznanych uprawnień.
- Nie wywołuj metody przed każdym żądaniem biznesowym; token już reprezentuje kontekst klienta.
Powiązana dokumentacja
Pobierz token dostępu OAuth2Wymień dane dostępowe CloudPrint API na krótkotrwały token Bearer OAuth2 w przepływie Client Credentials.Pobierz listę agentów drukuPobierz agentów CloudPrint konta oraz sprawdź ich status, wersję i stan aktualizacji.Pobierz listę dostępnych drukarekPobierz drukarki widoczne przez agentów CloudPrint i wybierz stabilny printer_id dla procesu.