PDF i języki drukarek RAW
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 | 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:
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.