---
title: "CloudPrint Developer Platform"
description: "Zbuduj jedną aplikację instalowaną przez klientów na ich kontach CloudPrint poprzez stabilne App Installations."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Developer Platform</span></nav>

# CloudPrint Developer Platform

<p class="docs-lead">Developer Platform służy produktom, które łączą się z istniejącymi kontami CloudPrint różnych klientów. Klient instaluje aplikację raz, a Twój serwer pobiera dla tej instalacji krótkotrwałe tokeny bez ponownego wyrażania zgody przed każdym wydrukiem.</p>

## Kiedy wybrać ten model

Zwykłe [API Credentials](../api/authentication/) wystarczą, jeśli serwer drukuje tylko na koncie Twojej firmy. Developer Platform jest przeznaczona dla SaaS, ERP, WMS i innych produktów obsługujących niezależnych klientów z własnymi kontami CloudPrint. Jeśli produkt sam tworzy konta CloudPrint dla klientów, użyj [Partner Platform](../partner-platform/).

## Do kogo należy aplikacja i konto

Developer Application należy do Twojego Developer Account. Na każdym koncie klienta aplikacja może mieć jedną App Installation. Klient pozostaje właścicielem swojego konta i sam zatwierdza uprawnienia. Do powiązania klienta używaj identyfikatora ze swojego systemu, a nie CloudPrint `account_id`.

## Jak przebiega podłączenie

Utwórz Developer Account, zarejestruj Application, dodaj klucz publiczny RS256 i wyślij klientowi link instalacyjny. Po powrocie użytkownika sprawdź `state`, zapisz `installation_id` przy identyfikatorze klienta, podpisz jednorazowy assertion JWT aplikacji i wymień go na Installation Access Token. Tego tokenu używaj do wywołań [Print API](../api/overview/).

## Nie mieszaj danych dostępowych

Klucz prywatny uwierzytelnia Developer Application, ale sam nie daje dostępu do `/api/v1/*`. Installation Access Token działa tylko dla jednego konta CloudPrint i w zakresie zatwierdzonych uprawnień. Dla każdej wymiany twórz nowy assertion, przechowuj token prawie do wygaśnięcia i nie zapisuj kluczy ani tokenów w logach.

## Które identyfikatory zapisać

Przechowuj identyfikator klienta ze swojego systemu, `application_id`, `installation_id`, CloudPrint `account_id`, zatwierdzone uprawnienia i stan instalacji. Stałym powiązaniem z kontem klienta jest `installation_id`; access token jest krótkotrwały. Nowy token nie tworzy kolejnej instalacji i nie wymaga ponownej zgody.

## Zawieszenie i odwołanie dostępu

Rozróżniaj stany `suspended` i `revoked`. Zawieszoną instalację można wznowić, a odwołanej nie można przywrócić — kolejne podłączenie otrzyma nowy `installation_id`. Ograniczenie uprawnień działa od razu, a ich rozszerzenie wymaga ponownej zgody właściciela konta.

## 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/developer-platform/applications/"><strong>Tworzenie i uwierzytelnianie aplikacji</strong><span>Utwórz Developer Account i Developer Application, zarejestruj klucze RS256 i uwierzytelnij backend aplikacji.</span></a>
<a class="docs-card" href="/pl/docs/developer-platform/installations/"><strong>Instalacje i tokeny dostępu</strong><span>Instaluj aplikację na kontach klientów, zapisuj installation_id i wydawaj krótkotrwałe Installation Access Tokens.</span></a>
<a class="docs-card" href="/pl/docs/partner-platform/"><strong>CloudPrint Partner Platform</strong><span>Twórz i obsługuj odizolowane konta klientów CloudPrint z produktu embedded lub white-label.</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>