CloudPrint przyjmuje gotowe pliki PDF oraz cztery jawne języki drukarek w trybie RAW: ZPL, TSPL, CPCL i ESC/POS. Integracja deklaruje język dokumentu, agent wykrywa możliwości drukarki, a API blokuje niezgodne trasy.
## Wybierz właściwy typ danych | Dane | `document_format` | `document_raw_language` | Typowe zastosowanie | | --- | --- | --- | --- | | PDF | `pdf` | pomiń | faktury, dokumenty dostawy i etykiety stronicowe | | ZPL | `raw` | `zpl` | etykiety termiczne | | TSPL / TSPL-EZ | `raw` | `tspl` | etykiety termiczne | | CPCL | `raw` | `cpcl` | mobilne i kompaktowe drukarki etykiet | | ESC/POS | `raw` | `escpos` | paragony i drukarki kasowe | W API obowiązują dokładne wartości z tabeli. Urządzenie TSPL-EZ może zgłaszać kilka zgodnych profili; wybierz wyłącznie język reklamowany przez daną drukarkę. ## Korzystaj z wykrytych możliwości Pobierz `GET /api/v1/printers` i sprawdź `capabilities.language_profiles` razem z `endpoint.raw_passthrough_available`. Agent wykrywa te możliwości z danych drukarki. Nie wnioskuj o języku z marki, modelu ani nazwy kolejki i nie każ operatorowi przypisywać go ręcznie. ## Przesyłaj RAW jawnie Ustaw oba pola RAW i prześlij oryginalne polecenia drukarki bez renderowania: ```bash RAW_LANGUAGE=tspl curl -sS https://public-api.cloudprint.me/api/v1/documents \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -F 'file=@label.prn;type=application/octet-stream' \ -F 'document_format=raw' \ -F "document_raw_language=$RAW_LANGUAGE" ``` Dozwolone wartości to `zpl`, `tspl`, `cpcl` i `escpos`. CloudPrint porównuje język z możliwościami drukarki, ale nie tłumaczy poleceń między językami. ## Nie mieszaj PDF i RAW Dla gotowego PDF ustaw `document_format=pdf` i pomiń `document_raw_language`. Kolejka potrzebuje drukowania systemowego albo obsługiwanej konwersji po stronie agenta. Nie oznaczaj bajtów PDF jako RAW. Panel CloudPrint przyjmuje PDF oraz te same jawne języki RAW co API: ZPL, TSPL, CPCL i ESC/POS. ## Testuj rzeczywisty sprzęt Przed wdrożeniem sprawdź każdą używaną drukarkę, sterownik lub kolejkę, język, DPI i nośnik. Przy błędzie zapisz `print_job_id`, `X-Request-Id`, przyczynę i zgłoszone możliwości. Gdy wydruk jest przesunięty lub nieczytelny, zweryfikuj oryginalne polecenia, rozmiar nośnika, kalibrację czujnika, gęstość i prędkość na fizycznym urządzeniu. Nie zapisuj treści dokumentów w logach. ## Następne kroki