---
title: "Przegląd CloudPrint Public API"
description: "Praktyczna mapa uwierzytelniania, drukarek, dokumentów, zadań, statusów i błędów w integracji CloudPrint."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Print API</span></nav>

# Przegląd CloudPrint Public API

<p class="docs-lead">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.</p>

## 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](../authentication/), wybór drukarki: [Agenci i drukarki](../agents-and-printers/), dane: [Dokumenty](../documents/), ponowienia i statusy: [Zadania](../print-jobs/), dokładne operacje i schematy: [API v1](../v1/).

## Następne kroki

<div class="docs-card-grid"><a class="docs-card" href="/pl/docs/api/authentication/"><strong>Uwierzytelnianie OAuth2 Client Credentials</strong><span>Utwórz aplikację API CloudPrint, pobieraj krótkotrwały token i chroń dane dostępowe, nadając tylko niezbędne uprawnienia.</span></a>
<a class="docs-card" href="/pl/docs/api/documents/"><strong>Przesyłanie dokumentów PDF i RAW</strong><span>Wybierz multipart, publiczny adres HTTPS lub Base64 i przygotuj plik PDF albo dane RAW języka drukarki.</span></a>
<a class="docs-card" href="/pl/docs/api/print-jobs/"><strong>Tworzenie i śledzenie zadań druku</strong><span>Twórz idempotentne zadania CloudPrint, sprawdzaj opcje drukarki i bezpiecznie śledź je aż do stanu końcowego.</span></a></div>

<nav class="docs-resource-links" aria-label="Następne kroki"><a href="https://cloudprint.me/status/">Status usługi</a><a href="/pl/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Otwórz panel</a><a href="/docs/legal/privacy/">Polityka prywatności</a><a href="/pl/docs/legal/terms/">Regulamin</a><a href="/pl/docs/legal/data-processing/">DPA</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>