Przegląd CloudPrint Public API
Ta strona opisuje Print API działające w ramach jednego konta. Pełna dokumentacja OpenAPI zawiera również operacje Developer Platform, Partner Management oraz publicznego pobierania Agenta.
Dokąd wysyłać żądania
Serwer wysyła wszystkie żądania API do https://public-api.cloudprint.me. Właściciel konta łączy agentów i tworzy aplikacje API w https://my.cloudprint.me. Zainstalowany agent używa wewnętrznego protokołu CloudPrint i nie jest przeznaczony do bezpośrednich wywołań przez systemy zewnętrzne.
Metody Print API
| Metoda | Ścieżka | Uprawnienie | Zastosowanie |
|---|---|---|---|
POST | /oauth/token | — | Pobranie tokenu OAuth2 |
GET | /api/v1/me | uwierzytelnienie | Sprawdzenie konta, aplikacji API i uprawnień |
GET | /api/v1/agents | agents:read | Stan i wersja agenta |
GET | /api/v1/printers | printers:read | Drukarki i ich możliwości |
POST | /api/v1/documents | documents:write | Przesłanie PDF lub RAW |
POST | /api/v1/print-jobs | print_jobs:write | Utworzenie zadania dla dokumentu |
POST | /api/v1/print-jobs/from-url | documents:write, print_jobs:write | Pobranie publicznego HTTPS i utworzenie zadania |
POST | /api/v1/print-jobs/from-base64 | documents:write, print_jobs:write | Dekodowanie danych osadzonych i utworzenie zadania |
GET | /api/v1/print-jobs | print_jobs:read | Lista zadań z paginacją kursorową |
GET | /api/v1/print-jobs/{printJobId} | print_jobs:read | Odczyt zadania i wyniku |
Kolejność implementacji
Najpierw zaimplementuj token i /me, potem podłączenie drukarki, dokument, idempotentne zadanie i odpytywanie statusu. URL i Base64 dodaj po uruchomieniu procesu dwuetapowego. /agents służy diagnostyce, a lista /print-jobs — uzgadnianiu historii.
Paginacja
Listy agentów, drukarek i zadań używają kursora. Wyślij limit 1–100, potem przekaż nieprzezroczysty next_cursor jako cursor. Zatrzymaj się przy null; nie analizuj i nie konstruuj kursora.
Zgodność
Stabilna ścieżka to /api/v1. Ignoruj nieznane pola i traktuj nieznane statusy jako pośrednie. Używaj wartości dozwolonych i ograniczeń z OpenAPI. Zmiany niezgodne wymagają nowej wersji głównej.
Gdzie szukać
Tokeny: Uwierzytelnianie, wybór drukarki: Agenci i drukarki, dane: Dokumenty, ponowienia i statusy: Zadania, dokładne operacje i schematy: API v1.