Połączenie agenta i wybór drukarki
Agent zgłasza kolejki systemowe przez połączenie wychodzące. Integracja odczytuje ich stan z Public API, zapisuje `printer_id` CloudPrint i sprawdza możliwości przed wydrukiem.
Sprawdź agenta
curl -sS 'https://public-api.cloudprint.me/api/v1/agents?limit=50' \
-H "Authorization: Bearer $ACCESS_TOKEN"{
"agents": [
{
"agent_id": "22222222-2222-4222-8222-222222222222",
"name": "Warehouse PC agent",
"status": "online",
"hostname": "warehouse-pc",
"version": "0.1.1",
"update": {
"status": "up_to_date",
"current_version": "0.1.1",
"latest_version": "0.1.1",
"minimum_supported_version": "0.1.0",
"channel": "stable",
"required": false
},
"last_seen_at": "2026-06-08T10:10:00+00:00"
}
],
"next_cursor": null
}Lista wymaga agents:read. Agent powinien być online; w diagnostyce sprawdzaj update.required i wersje.
Pobierz drukarki
curl -sS 'https://public-api.cloudprint.me/api/v1/printers?limit=100' \
-H "Authorization: Bearer $ACCESS_TOKEN"Skrócona odpowiedź z polami wyboru:
{
"printers": [
{
"printer_id": "11111111-1111-4111-8111-111111111111",
"agent_id": "22222222-2222-4222-8222-222222222222",
"name": "Warehouse Label Printer",
"status": "online",
"agent_name": "Warehouse PC agent",
"agent_status": "online",
"capabilities": {
"backend": "windows_native",
"language_profiles": [
{
"language": "zpl",
"version": "zpl2"
}
],
"supports_custom_media": true,
"supports_orientation": true,
"supports_copies": true,
"supported_dpi": [
203
]
},
"endpoint": {
"system_print_available": true,
"raw_passthrough_available": true,
"os": "windows",
"driver_name": "ZDesigner ZD421-203dpi ZPL",
"connection_type": "windows_spooler"
},
"status_evidence": {
"source": "windows_spooler",
"reasons": [
"paper_out"
],
"accepting_jobs": true,
"queued_jobs": 3
}
}
],
"next_cursor": null
}Zapisz właściwy identyfikator
Zapisz printer_id dla lokalizacji lub procesu. Pokaż administratorowi name, agent_name i status, ale nie wybieraj drukarki według nazwy. Po odtworzeniu kolejki wymagaj ponownego przypisania i testu.
Oddziel stan urządzenia od gotowości kolejki
status opisuje fizyczny lub skonfigurowany stan drukarki. status_evidence zawiera ostatnią obserwację kolejki: source to cups_ipp, windows_spooler, configured albo unknown; reasons zawiera znormalizowane warunki urządzenia i spoolera; accepting_jobs określa, czy natywny spooler może trwale przyjąć następne zadanie; queued_jobs jest migawką lokalnej kolejki systemowej, a nie liczbą oczekujących zadań CloudPrint. Wartości null nie potwierdzają gotowości. Agent online i natywne accepting_jobs=true mogą pozwalać na przyjęcie zadania podczas przejściowego ostrzeżenia urządzenia, ale ostrzeżenie trzeba pokazać operatorowi.
Sprawdź możliwości drukarki
RAW wymaga zgodnego language_profiles[*].language i wartości raw_passthrough_available=true. PDF wymaga druku systemowego lub obsługiwanego przez CloudPrint mechanizmu renderowania. Przed ustawieniem niestandardowego koloru, druku dwustronnego, orientacji, liczby kopii, nośnika, skali, przesunięcia lub DPI sprawdź odpowiednie pola możliwości.
Paginacja i niedostępne kolejki
Obie listy zwracają next_cursor. Używaj ?limit=100&cursor=VALUE, aż otrzymasz null. Wstrzymaj routing automatyczny, gdy agent jest offline albo natywne dane nie potwierdzają przyjmowania przez kolejkę. Nie wybieraj po cichu drukarki z innej lokalizacji.
Znaczenie danych połączenia
Pola sterownika, portu, systemu operacyjnego i typu połączenia opisują lokalną kolejkę i służą do diagnostyki. Nie jest to adres wywoływany przez serwer. Dane dostępowe w URI są ukrywane.