Druk z aplikacji webowej na lokalną drukarkę
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.
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.