Dokumentacja CloudPrint/Dokumentacja API

Pobierz listę zadań druku

Pobierz ostatnie zadania CloudPrint z paginacją kursorową dla ekranów operacyjnych i wsparcia.

GET/api/v1/print-jobsWersja API: v1operationId: listPrintJobsOtwórz w Markdown

Działanie metody

Pobierz ostatnie zadania CloudPrint z paginacją kursorową dla ekranów operacyjnych i wsparcia.

Uwierzytelnianie

Przekaż krótkotrwały token w Authorization: Bearer <access_token>.

Wymagane uprawnienia: print_jobs:read

Żądanie

Podstawowy adres API: https://public-api.cloudprint.me/api/v1/print-jobs

Parametry

Nazwa	Położenie	Typ	Wymagane	Opis	Ograniczenia
limit	query	integer	nie	Pole kontraktu API; uwzględnij podany typ i ograniczenia.	min: 1; max: 100; default: 20
cursor	query	string | null	nie	Pole kontraktu API; uwzględnij podany typ i ograniczenia.	—

Treść żądania

Metoda nie ma treści żądania.

Przykładowe żądania

cURL

curl -sS 'https://public-api.cloudprint.me/api/v1/print-jobs?limit=20' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Odpowiedź

Status HTTP: 200 — Żądanie zostało wykonane.

Pola odpowiedzi

Nazwa	Typ	Wymagane	Opis	Ograniczenia
print_jobs	array	tak	Zadania druku zwrócone dla bieżącego konta i filtrów.	—
next_cursor	string | null	tak	Nieprzezroczysty kursor następnej strony; przekaż go bez zmian.	—

Przykładowa odpowiedź

{
  "print_jobs": [
    {
      "print_job_id": "11111111-1111-4111-8111-111111111111",
      "document_id": "11111111-1111-4111-8111-111111111111",
      "document_mime_type": "application/pdf",
      "document_format": "pdf",
      "document_raw_language": null,
      "printer_id": "11111111-1111-4111-8111-111111111111",
      "status": "pending",
      "copies": 1,
      "intent": "shipping_label",
      "color_mode": "default",
      "duplex_mode": "default",
      "media_width_mm": 58,
      "media_height_mm": 40,
      "dpi": 203,
      "scale_mode": "none",
      "orientation": "default",
      "offset_x_mm": 0,
      "offset_y_mm": 0,
      "margin_top_mm": 0,
      "margin_right_mm": 0,
      "margin_bottom_mm": 0,
      "margin_left_mm": 0,
      "created_at": "2026-08-06T12:00:00Z",
      "reserved_at": null,
      "started_at": null,
      "completed_at": null,
      "failure_reason": null
    }
  ],
  "next_cursor": null
}

Błędy

Status HTTP	Opis
401	Brak uwierzytelnienia albo jest ono nieprawidłowe.
403	Brak uprawnień wymaganych do tej operacji.
422	Pola żądania nie przeszły walidacji.
429	Przekroczono limit żądań; zastosuj Retry-After.
500	Wewnętrzny błąd CloudPrint.

Wskazówki integracyjne

• Przekazuj next_cursor bez zmian; nie twórz kursora samodzielnie.
• Metoda nadaje się do ekranów operacyjnych i wsparcia; znane zadanie odczytuj po identyfikatorze.

Powiązana dokumentacja

Pobierz status zadania drukuOdczytuj zadanie CloudPrint, aż osiągnie końcowy status printed albo failed.Tworzenie i śledzenie zadań drukuTwórz idempotentne zadania CloudPrint, sprawdzaj opcje drukarki i bezpiecznie śledź je aż do stanu końcowego.Błędy i ponowienia CloudPrint APIObsługuj statusy HTTP, błędy maszynowe, limity, identyfikatory żądań i bezpieczne ponowienia.

OpenAPIOtwórz panelPolityka prywatnościRegulaminPłatności i zwrotyDPA