---
title: "CloudPrint Partner Platform"
description: "Twórz i obsługuj odizolowane konta klientów CloudPrint z produktu embedded lub white-label."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Partner Platform</span></nav>

# CloudPrint Partner Platform

<p class="docs-lead">Partner Platform jest przeznaczona dla produktów, które samodzielnie tworzą i obsługują osobne konta CloudPrint dla klientów. Klient nie musi rejestrować się w CloudPrint, ale Twój produkt nadal korzysta z Developer Application i App Installation.</p>

## Kiedy wybrać Partner Platform

Developer Platform służy klientom, którzy mają już konto CloudPrint i sami zatwierdzają instalację. Partner Platform jest właściwa, gdy tworzenie konta jest częścią Twojego produktu lub działa pod Twoją marką. Jeśli drukujesz tylko dla własnej firmy, wybierz prostsze [API Credentials](../api/authentication/).

## Co jest wymagane

Dostęp do API wymaga aktywnych Developer Account i Developer Application, ważnego klucza RS256 oraz aktywnego udziału w Partner Program. Za użycie produkcyjne rozliczana jest organizacja partnera zgodnie z podpisaną umową handlową.

## Zarejestruj callback podłączenia

Dodaj dokładny callback 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 do tego callbacku 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. 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 nowy jednorazowy assertion RS256 z `aud=https://public-api.cloudprint.me/partner-api/v1` i wyślij `Authorization: Bearer <application_assertion>`. Drukowanie używa innego credential: pobierz Installation Access Token przez `POST /developer-api/v1/app-installations/{installationId}/access-tokens`, a potem wywołuj `/api/v1/*`.

## Obsługa klienta pozostaje w Twoim produkcie

Odpowiadasz za onboarding, mapowanie klienta i pierwszą linię wsparcia. Pokazuj health relacji, Agents, drukarki i usage we własnym produkcie, zapisuj `X-Request-Id` i nigdy nie loguj private key, assertions ani kodów Enrollment.

## Uwzględnij limity i stan handlowy

Partner API dopuszcza 300 żądań z jednego source IP i 1 200 żądań uwierzytelnionej Application w oknie 60 sekund. Po `429` stosuj `Retry-After` oraz nagłówki `X-RateLimit-*`. CloudPrint wystawia partnerowi miesięczną fakturę o stałej kwocie; managed accounts, Agents i print jobs są nielimitowane, jeśli umowa nie stanowi inaczej.

## Lista kontrolna przed wdrożeniem

- Korzystaj z wychodzącego połączenia agenta; nie wystawiaj portów drukarki do internetu.
- Zapisuj stabilny identyfikator drukarki, a nie tylko jej nazwę.
- Sprawdzaj format dokumentu, rozmiar strony i orientację przed utworzeniem zadania.
- Jawnie obsługuj status końcowy, ponowienia i ochronę przed podwójnym drukiem.

## Następne kroki

<div class="docs-card-grid"><a class="docs-card" href="/pl/docs/partner-platform/customer-accounts/"><strong>Tworzenie i zarządzanie kontami klientów</strong><span>Uwierzytelniaj Partner API, twórz zarządzane konta klientów i bezpiecznie kontroluj ich cykl życia.</span></a>
<a class="docs-card" href="/pl/docs/partner-platform/agent-enrollment/"><strong>Rejestracja agenta klienta</strong><span>Połącz lokalnego agenta CloudPrint z właściwym zarządzanym kontem bez logowania klienta do panelu CloudPrint.</span></a>
<a class="docs-card" href="/pl/docs/developer-platform/"><strong>CloudPrint Developer Platform</strong><span>Zbuduj jedną aplikację instalowaną przez klientów na ich kontach CloudPrint poprzez stabilne App Installations.</span></a></div>

<nav class="docs-resource-links" aria-label="Następne kroki"><a href="/pl/docs/api/v1/explorer/">OpenAPI</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/payments-and-refunds/">Płatności i zwroty</a><a href="/pl/docs/legal/data-processing/">DPA</a></nav>