---
title: "Druk z aplikacji webowej na lokalną drukarkę"
description: "Dodaj niezawodny druk do SaaS lub aplikacji webowej bez otwierania portów i bez okna drukowania przeglądarki."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Procesy drukowania</span></nav>

# Druk z aplikacji webowej na lokalną drukarkę

<p class="docs-lead">Drukowanie z aplikacji internetowej powinno zaczynać się po stronie serwera, a nie w oknie drukowania przeglądarki. Dzięki temu system wybiera właściwą drukarkę, może zapobiec duplikatom i pokazuje rzeczywisty status zadania.</p>

## Wysyłaj zadania z własnego serwera

Interfejs wysyła do serwera identyfikator dokumentu oraz wybraną lokalizację lub drukarkę. Serwer generuje lub pobiera plik, wywołuje CloudPrint Public API i zwraca własny identyfikator operacji. `client_secret` ani token Bearer nie trafiają do przeglądarki.

## Wybór drukarki

Podczas konfiguracji pobierz drukarki z `GET /api/v1/printers` i zapisz stabilny `printer_id`. W interfejsie można pokazywać nazwę, agenta i status online, ale nazwa nie powinna być kluczem routingu.

## Doświadczenie operatora

Po kliknięciu „Drukuj” pokaż stan przyjęcia, oczekiwania, drukowania i wynik. Zablokuj przypadkowe wielokrotne kliknięcie, ale umożliw świadomy ponowny wydruk jako nową operację. Przy błędzie pokaż czytelny komunikat oraz identyfikator potrzebny wsparciu.

## Odporność na problemy sieciowe

Zaplecze powinno używać stabilnego `Idempotency-Key`, zapisać `print_job_id` i kontynuować odczyt statusu po odświeżeniu strony. Po przekroczeniu limitu czasu nie zakładaj, że zadanie nie powstało — najpierw ponów to samo bezpieczne żądanie albo sprawdź zapisany wynik.

## Czego unikać

Nie wywołuj agenta z przeglądarki, nie udostępniaj drukarek w internecie, nie przechowuj sekretów w `localStorage` i nie traktuj przyjęcia żądania jako potwierdzenia wydruku. Status `printed` potwierdza przyjęcie przez kolejkę systemową, a nie fizyczny wydruk.

## Następne kroki

<div class="docs-card-grid"><a class="docs-card" href="/pl/docs/getting-started/"><strong>Szybki start z CloudPrint API</strong><span>Połącz agenta, pobierz token OAuth, wybierz drukarkę, wyślij pierwsze zadanie i sprawdź jego stan końcowy.</span></a>
<a class="docs-card" href="/pl/docs/guides/erp-wms-printing/"><strong>Druk z systemów ERP i WMS</strong><span>Automatyzuj druk faktur, dokumentów magazynowych i etykiet z ERP, WMS lub innego systemu biznesowego, zachowując kontrolę nad drukarką i wynikiem.</span></a>
<a class="docs-card" href="/pl/docs/api/print-jobs/"><strong>Tworzenie i śledzenie zadań druku</strong><span>Twórz idempotentne zadania CloudPrint, sprawdzaj opcje drukarki i bezpiecznie śledź je aż do stanu końcowego.</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>