Jak CloudPrint drukuje na lokalnych drukarkach
CloudPrint łączy aplikację działającą w chmurze z drukarką znajdującą się w biurze, sklepie lub magazynie. Aplikacja korzysta wyłącznie z Public API, a lokalny agent bezpiecznie odbiera dozwolone zadania przez połączenie wychodzące.
Elementy rozwiązania
Backend klienta pobiera token, wybiera printer_id, przekazuje dokument i tworzy zadanie. CloudPrint przechowuje dokument oraz stan zadania. Lokalny agent zgłasza drukarki, rezerwuje pracę i przekazuje ją do systemowej kolejki albo zgodnego kanału RAW.
Dlaczego agent jest potrzebny
Drukarki zwykle działają w prywatnych sieciach i nie powinny być dostępne publicznie. Agent inicjuje połączenie na zewnątrz, dlatego wdrożenie nie wymaga przekierowania portów, VPN ani zdalnego pulpitu.
Cykl życia zadania
Nowe zadanie zaczyna od pending, następnie może przejść przez reserved i printing. Końcowe statusy to printed oraz failed. Integracja powinna przechowywać print_job_id, tolerować przyszłe statusy pośrednie i pokazywać operatorowi czytelny wynik.
Bezpieczne ponowienia
Problemy sieciowe nie powinny powodować drugiego wydruku. Dla każdej operacji generuj stabilny Idempotency-Key. Ten sam klucz i payload zwracają pierwotne zadanie, natomiast zmieniony payload powoduje 409 Conflict.
Granice odpowiedzialności
CloudPrint dostarcza zadanie do drukarki i raportuje wynik dostępny dla agenta. Aplikacja klienta odpowiada za wybór właściwej drukarki, przygotowanie pliku, powiązanie zadania z dokumentem biznesowym oraz sposób prezentacji błędu użytkownikowi.
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ę.
- Jawnie obsługuj status końcowy, ponowienia i ochronę przed podwójnym drukiem.
- Zapisuj identyfikatory zadań i przyczyny błędów na potrzeby wsparcia i monitoringu.