---
title: "Konta zarządzane w CloudPrint Developer Platform"
description: "Twórz izolowane konta CloudPrint dla klientów i zarządzaj nimi we własnym produkcie."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Developer Platform</span></nav>

# Konta zarządzane w CloudPrint Developer Platform

<p class="docs-lead">Konta zarządzane są przeznaczone dla produktów, które samodzielnie tworzą i obsługują osobne konta CloudPrint dla klientów. To jeden z modeli podłączenia w Developer Platform; stabilny kontrakt zarządzania nosi nazwę Partner API.</p>

## Wybierz właściwy proces

Gdy klient ma już konto CloudPrint, użyj App Installation zatwierdzanej przez właściciela. Konto zarządzane sprawdzi się we wbudowanym procesie lub rozwiązaniu pod własną marką, gdy konto tworzy Twój serwer. Do drukowania wyłącznie dla własnej firmy wybierz prostsze [API Credentials](../../api/authentication/).

## Co jest wymagane

Dostęp do API wymaga Developer Account z aktywnym dostępem produkcyjnym, aktywnej Developer Application i ważnego klucza RS256. Za korzystanie z usługi produkcyjnej płaci organizacja Developer Account zgodnie z podpisaną umową handlową.

## Zarejestruj adres powrotu

Dodaj dokładny adres powrotu jako `redirect_uri` Developer Application, a następnie przekaż tę samą wartość w `agent_onboarding.return_uri` podczas tworzenia konta lub Enrollment. CloudPrint odeśle operatora pod ten adres z pierwotnym `state`; zweryfikuj go przed przyjęciem wyniku.

## Co powstaje dla klienta

Jedno żądanie tworzy osobne CloudPrint Account, App Installation Twojej aplikacji i Partner Account Relationship. Pole `external_customer_id` łączy rekord z klientem i musi być unikalne w obrębie tej Developer Application. Inna aplikacja może użyć tej samej wartości dla własnego klienta. Zapisz `relationship_id` do zarządzania klientem przez Partner API oraz `installation_id` do wydawania tokenów Print API. `cloudprint_account_id` służy tylko do weryfikacji.

## Oddziel zarządzanie od drukowania

Dla każdego żądania `/partner-api/v1/*` podpisz nowe jednorazowe potwierdzenie JWT RS256 z `aud=https://public-api.cloudprint.me/partner-api/v1` i wyślij je jako `Authorization: Bearer <application_assertion>`. Drukowanie korzysta z innego tokenu: pobierz Installation Access Token przez `POST /developer-api/v1/app-installations/{installationId}/access-tokens`, a następnie wywołuj `/api/v1/*`.

## Obsługa klienta pozostaje w Twoim produkcie

Odpowiadasz za podłączenie klienta, powiązanie kont i pierwszą linię wsparcia. Pokazuj stan konta, agentów, drukarek i wykorzystanie usługi we własnym produkcie. Zapisuj `X-Request-Id`, ale nigdy nie umieszczaj w logach kluczy prywatnych, potwierdzeń JWT ani kodów Enrollment.

## Uwzględnij limity i rozliczenia

Partner API dopuszcza 300 żądań z jednego adresu IP i 1 200 żądań jednej uwierzytelnionej aplikacji w ciągu 60 sekund. Po `429` stosuj `Retry-After` oraz nagłówki `X-RateLimit-*`. CloudPrint wystawia organizacji Developer Account miesięczną fakturę na uzgodnioną kwotę zamiast naliczać opłatę za każde zadanie. Nie ma miesięcznego limitu wykorzystania, o ile umowa nie stanowi inaczej; nadal obowiązują opublikowane limity częstotliwości żądań i zabezpieczenia kolejki.

## Następne kroki

<div class="docs-card-grid"><a class="docs-card" href="/pl/docs/developer-platform/managed-accounts/account-lifecycle/"><strong>Tworzenie i zarządzanie kontami klientów</strong><span>Uwierzytelniaj żądania Partner API, twórz konta zarządzane oraz wstrzymuj, wznawiaj lub zamykaj je w razie potrzeby.</span></a>
<a class="docs-card" href="/pl/docs/developer-platform/managed-accounts/agent-setup/"><strong>Konfiguracja agenta dla konta zarządzanego</strong><span>Utwórz jednorazowy link i połącz CloudPrint Agent z właściwym kontem klienta bez logowania do panelu.</span></a>
<a class="docs-card" href="/pl/docs/developer-platform/"><strong>CloudPrint Developer Platform dla aplikacji klientów</strong><span>Zbuduj jedną aplikację, którą klienci mogą połączyć ze swoimi kontami CloudPrint.</span></a></div>

<nav class="docs-resource-links" aria-label="Następne kroki"><a href="https://cloudprint.me/status/">Status usługi</a><a href="/pl/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Otwórz panel</a><a href="/docs/legal/privacy/">Polityka prywatności</a><a href="/pl/docs/legal/terms/">Regulamin</a><a href="/pl/docs/legal/data-processing/">DPA</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>