Dokumentacja CloudPrint/Dokumentacja API

Pobierz zarządzane konto klienta

Pobierz konto klienta według stałego `relationship_id`.

GET/partner-api/v1/accounts/{relationshipId}Wersja API: v1operationId: getPartnerManagedAccountOtwórz w Markdown

Działanie metody

Pobierz konto klienta według stałego relationship_id.

Uwierzytelnianie

Przekaż jednorazowe potwierdzenie JWT Developer Application podpisane algorytmem RS256 w Authorization: Bearer <application_assertion>. Nie jest to token dostępu do Public API.

Żądanie

Podstawowy adres API: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}

Parametry

Nazwa	Położenie	Typ	Wymagane	Opis	Ograniczenia
relationshipId	path	string (uuid)	tak	Stabilny UUID relacji partnera z zarządzanym klientem.	—
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

curl -sS "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID" \
  -H "Authorization: Bearer $APPLICATION_ASSERTION"

Odpowiedź

Status HTTP: 200 — Żądanie zostało wykonane.

Pola odpowiedzi

Nazwa	Typ	Wymagane	Opis	Ograniczenia
relationship_id	string (uuid)	tak	Stabilny UUID relacji partnera z zarządzanym klientem.	—
developer_account_id	string (uuid)	tak	Stabilny UUID konta dewelopera, do którego należy relacja z klientem.	—
cloudprint_account_id	string (uuid)	tak	Stabilny UUID konta CloudPrint utworzonego dla zarządzanego klienta.	—
external_customer_id	string	tak	Stały identyfikator klienta w systemie integratora. Musi być unikalny w obrębie uwierzytelnionej Developer Application.	maxLength: 160
name	string	tak	Czytelna nazwa zasobu widoczna dla operatorów konta.	maxLength: 120
application_id	string (uuid)	tak	Stabilny identyfikator Developer Application reprezentowanej przez token instalacji.	—
installation_id	string | null (uuid)	tak	Stabilny UUID App Installation, która autoryzowała token.	—
agent_enrollment_id	string | null (uuid)	tak	Stabilny identyfikator Agent Enrollment.	—
agent_onboarding_expires_at	string | null (date-time)	tak	Znacznik czasu CloudPrint w formacie ISO 8601.	—
agent_onboarding_url	string | null (uri)	tak	Główny jednorazowy link do podłączenia agenta. Otwórz go w całości, nie zmieniaj i nie zapisuj w logach.	example: "https://connect.cloudprint.me/setup#token=cpat_example"
onboarding_status	string	tak	Bieżący stan gotowości konfiguracji CloudPrint zarządzanego klienta.	enum: provisioning, waiting_for_agent, ready, failed
status	string	tak	Bieżący stan zasobu lub procesu; użyj wartości dozwolonych dla danej metody.	enum: provisioning, active, suspended, closed
created_at	string (date-time)	tak	Znacznik czasu CloudPrint w formacie ISO 8601.	—
updated_at	string (date-time)	tak	Znacznik czasu CloudPrint w formacie ISO 8601.	—
health	object	tak	Zbiorczy stan agentów i drukarek zarządzanego klienta.	—

Przykładowa odpowiedź

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

Błędy

Status HTTP	Opis
401	Brak uwierzytelnienia albo jest ono nieprawidłowe.
403	Brak uprawnień wymaganych do tej operacji.
404	Nie znaleziono żądanego zasobu.
422	Pola żądania nie przeszły walidacji.
429	Przekroczono limit żądań; zastosuj Retry-After.
500	Wewnętrzny błąd CloudPrint.

Powiązana dokumentacja

Pobierz zarządzane konta klientówPobierz konta klientów utworzone przez uwierzytelnioną Developer Application wraz ze stanem agentów i drukarek.Tworzenie i zarządzanie kontami klientówUwierzytelniaj żądania Partner API, twórz konta zarządzane oraz wstrzymuj, wznawiaj lub zamykaj je w razie potrzeby.Pobierz agentów klientaPobierz wszystkich agentów zarządzanego klienta, w tym odwołanych.

Status usługiOpenAPIDeveloper PortalOtwórz panelPolityka prywatnościRegulaminDPAService Level Agreement