---
title: "Utwórz zadanie z Base64"
description: "Zdekoduj mały dokument Base64 i jednym żądaniem utwórz dokument oraz zadanie CloudPrint."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Dokumentacja API</span></nav>

# Utwórz zadanie z Base64

<p class="docs-lead">Zdekoduj mały dokument Base64 i jednym żądaniem utwórz dokument oraz zadanie CloudPrint.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-post">POST</span><code>/api/v1/print-jobs/from-base64</code><span><strong>Wersja API:</strong> v1</span><span><strong>operationId:</strong> <code>createPrintJobFromBase64</code></span><a href="/pl/docs/api/v1/print-jobs/create-from-base64/index.md">Otwórz w Markdown</a></div>

## Działanie metody

Zdekoduj mały dokument Base64 i jednym żądaniem utwórz dokument oraz zadanie CloudPrint.

## Uwierzytelnianie

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

**Wymagane uprawnienia:** `print_jobs:write`

## Żądanie

**Podstawowy adres API:** `https://public-api.cloudprint.me/api/v1/print-jobs/from-base64`

### Parametry

| Nazwa | Położenie | Typ | Wymagane | Opis | Ograniczenia |
| --- | --- | --- | --- | --- | --- |
| `Idempotency-Key` | header | `string` | nie | Pole kontraktu API; uwzględnij podany typ i ograniczenia. | maxLength: 128 |

### Treść żądania

**Typ zawartości:** `application/json`

| Nazwa | Typ | Wymagane | Opis | Ograniczenia |
| --- | --- | --- | --- | --- |
| `document_base64` | `string (byte)` | tak | Pełna zawartość dokumentu w Base64 bez prefiksu data URL. | — |
| `document_filename` | `string \| null` | nie | Nazwa pliku używana do wykrycia formatu i diagnostyki operatora. | example: `"order-100045.pdf"` |
| `document_format` | `string \| null` | nie | Jawny format druku, na przykład `pdf` albo `raw`. | enum: `pdf`, `raw`; example: `"pdf"` |
| `document_raw_language` | `string \| null` | nie | Język poleceń danych RAW, na przykład ZPL lub EPL. | enum: `tspl`, `zpl`, `cpcl`, `escpos`; example: `null` |
| `printer_id` | `string (uuid)` | tak | Stabilny UUID drukarki docelowej w CloudPrint. | — |
| `copies` | `integer` | nie | Liczba kopii, które CloudPrint zleci drukarce. | min: 1; max: 99; example: `1` |
| `intent` | `string` | nie | Cel biznesowy zadania, używany w diagnostyce i doborze rozsądnych ustawień domyślnych. | enum: `document`, `shipping_label`, `product_label`, `invoice`, `packing_slip`, `a4_document`, `receipt`; example: `"shipping_label"` |
| `color_mode` | `string` | nie | Tryb koloru; `default` pozostawia wybór konfiguracji drukarki. | enum: `default`, `monochrome`, `color`; example: `"default"` |
| `duplex_mode` | `string` | nie | Żądany tryb druku jednostronnego lub dwustronnego. | enum: `default`, `simplex`, `duplex_long_edge`, `duplex_short_edge`; example: `"default"` |
| `media_width_mm` | `number \| null` | nie | Żądana szerokość nośnika lub etykiety w milimetrach. | min: 1; max: 2000; example: `58` |
| `media_height_mm` | `number \| null` | nie | Żądana wysokość nośnika lub etykiety w milimetrach. | min: 1; max: 2000; example: `40` |
| `dpi` | `integer \| null` | nie | Docelowa rozdzielczość druku w punktach na cal; użyj wartości obsługiwanej przez drukarkę. | min: 72; max: 2400; example: `203` |
| `scale_mode` | `string` | nie | Określa, czy zachować rozmiar dokumentu, czy dopasować go do nośnika. | enum: `none`, `fit`; example: `"none"` |
| `orientation` | `string` | nie | Orientacja strony; `default` używa ustawień drukarki. | enum: `default`, `portrait`, `landscape`; example: `"default"` |
| `offset_x_mm` | `number` | nie | Poziome przesunięcie druku w milimetrach. | min: -2000; max: 2000; example: `0` |
| `offset_y_mm` | `number` | nie | Pionowe przesunięcie druku w milimetrach. | min: -2000; max: 2000; example: `0` |
| `margin_top_mm` | `number` | nie | Dodatkowy margines druku w milimetrach. | min: 0; max: 2000; example: `0` |
| `margin_right_mm` | `number` | nie | Dodatkowy margines druku w milimetrach. | min: 0; max: 2000; example: `0` |
| `margin_bottom_mm` | `number` | nie | Dodatkowy margines druku w milimetrach. | min: 0; max: 2000; example: `0` |
| `margin_left_mm` | `number` | nie | Dodatkowy margines druku w milimetrach. | min: 0; max: 2000; example: `0` |

### Przykładowe żądania

#### cURL

```bash
curl -sS https://public-api.cloudprint.me/api/v1/print-jobs/from-base64 \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: order-100045-label' \
  -d '{
    "document_base64": "JVBERi0xLjQK...",
    "document_filename": "order-100045.pdf",
    "printer_id": "11111111-1111-4111-8111-111111111111",
    "copies": 1,
    "intent": "shipping_label",
    "media_width_mm": 58,
    "media_height_mm": 40,
    "dpi": 203
  }'
```

## Odpowiedź

**Status HTTP:** `201` — Zasób został utworzony.

### Pola odpowiedzi

| Nazwa | Typ | Wymagane | Opis | Ograniczenia |
| --- | --- | --- | --- | --- |
| `print_job_id` | `string (uuid)` | tak | Stabilny UUID zadania druku; zapisz go do sprawdzania statusu i obsługi. | — |
| `document_id` | `string (uuid)` | tak | Stabilny UUID zwracany po pomyślnym przesłaniu dokumentu. | — |
| `document_mime_type` | `string` | tak | Typ MIME przekazanego dokumentu. | example: `"application/pdf"` |
| `document_format` | `string` | tak | Jawny format druku, na przykład `pdf` albo `raw`. | enum: `pdf`, `raw`; example: `"pdf"` |
| `document_raw_language` | `string \| null` | tak | Język poleceń danych RAW, na przykład ZPL lub EPL. | enum: `tspl`, `zpl`, `cpcl`, `escpos`; example: `null` |
| `printer_id` | `string (uuid)` | tak | Stabilny UUID drukarki docelowej w CloudPrint. | — |
| `status` | `string` | tak | Bieżący stan zasobu lub procesu; użyj wartości dozwolonych dla danej metody. | enum: `pending`, `reserved`, `printing`, `printed`, `failed`, `cancelled`; example: `"pending"` |
| `copies` | `integer` | tak | Liczba kopii, które CloudPrint zleci drukarce. | min: 1; max: 99; example: `1` |
| `intent` | `string` | tak | Cel biznesowy zadania, używany w diagnostyce i doborze rozsądnych ustawień domyślnych. | enum: `document`, `shipping_label`, `product_label`, `invoice`, `packing_slip`, `a4_document`, `receipt`; example: `"shipping_label"` |
| `color_mode` | `string` | tak | Tryb koloru; `default` pozostawia wybór konfiguracji drukarki. | enum: `default`, `monochrome`, `color`; example: `"default"` |
| `duplex_mode` | `string` | tak | Żądany tryb druku jednostronnego lub dwustronnego. | enum: `default`, `simplex`, `duplex_long_edge`, `duplex_short_edge`; example: `"default"` |
| `media_width_mm` | `number \| null` | tak | Żądana szerokość nośnika lub etykiety w milimetrach. | min: 1; max: 2000; example: `58` |
| `media_height_mm` | `number \| null` | tak | Żądana wysokość nośnika lub etykiety w milimetrach. | min: 1; max: 2000; example: `40` |
| `dpi` | `integer \| null` | tak | Docelowa rozdzielczość druku w punktach na cal; użyj wartości obsługiwanej przez drukarkę. | min: 72; max: 2400; example: `203` |
| `scale_mode` | `string` | tak | Określa, czy zachować rozmiar dokumentu, czy dopasować go do nośnika. | enum: `none`, `fit`; example: `"none"` |
| `orientation` | `string` | tak | Orientacja strony; `default` używa ustawień drukarki. | enum: `default`, `portrait`, `landscape`; example: `"default"` |
| `offset_x_mm` | `number` | tak | Poziome przesunięcie druku w milimetrach. | min: -2000; max: 2000; example: `0` |
| `offset_y_mm` | `number` | tak | Pionowe przesunięcie druku w milimetrach. | min: -2000; max: 2000; example: `0` |
| `margin_top_mm` | `number` | tak | Dodatkowy margines druku w milimetrach. | min: 0; max: 2000; example: `0` |
| `margin_right_mm` | `number` | tak | Dodatkowy margines druku w milimetrach. | min: 0; max: 2000; example: `0` |
| `margin_bottom_mm` | `number` | tak | Dodatkowy margines druku w milimetrach. | min: 0; max: 2000; example: `0` |
| `margin_left_mm` | `number` | tak | Dodatkowy margines druku w milimetrach. | min: 0; max: 2000; example: `0` |
| `created_at` | `string (date-time)` | tak | Znacznik czasu CloudPrint w formacie ISO 8601. | — |
| `reserved_at` | `string \| null (date-time)` | tak | Znacznik czasu CloudPrint w formacie ISO 8601. | — |
| `started_at` | `string \| null (date-time)` | tak | Znacznik czasu CloudPrint w formacie ISO 8601. | — |
| `completed_at` | `string \| null (date-time)` | tak | Znacznik czasu CloudPrint w formacie ISO 8601. | — |
| `failure_reason` | `string \| null` | tak | Maszynowo czytelna lub diagnostyczna przyczyna nieudanego druku. | — |

### Przykładowa odpowiedź

```json
{
  "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
}
```

## Błędy

| Status HTTP | Opis |
| --- | --- |
| `400` | Sprawdź format i parametry żądania. |
| `401` | Brak uwierzytelnienia albo jest ono nieprawidłowe. |
| `403` | Brak uprawnień wymaganych do tej operacji. |
| `409` | Żądanie jest sprzeczne z bieżącym stanem zasobu. |
| `413` | Treść żądania przekracza dozwolony rozmiar. |
| `415` | Format treści nie jest obsługiwany. |
| `422` | Pola żądania nie przeszły walidacji. |
| `429` | Przekroczono limit żądań; zastosuj Retry-After. |
| `500` | Wewnętrzny błąd CloudPrint. |

## Wskazówki integracyjne

- Base64 zwiększa rozmiar żądania; dla większych dokumentów wybierz multipart lub publiczny URL HTTPS.
- Używaj skrótu dla małych paragonów lub etykiet, gdy osobne przesłanie jest niepraktyczne.
- Stosuj te same zasady idempotencji i śledzenia statusu.

## Powiązana dokumentacja

<div class="docs-card-grid"><a class="docs-card" href="/pl/docs/api/v1/print-jobs/create-from-url/"><strong>Utwórz zadanie z adresu URL</strong><span>Pobierz dokument z publicznego URL HTTPS i jednym żądaniem utwórz dokument oraz zadanie CloudPrint.</span></a>
<a class="docs-card" href="/pl/docs/api/v1/print-jobs/create/"><strong>Utwórz zadanie druku</strong><span>Wyślij przesłany dokument CloudPrint na wybraną drukarkę z idempotencją i jawnymi opcjami.</span></a>
<a class="docs-card" href="/pl/docs/api/v1/print-jobs/get/"><strong>Pobierz status zadania druku</strong><span>Odczytuj zadanie CloudPrint, aż osiągnie końcowy status printed albo failed.</span></a></div>

<nav class="docs-resource-links" aria-label="Następne kroki"><a href="/pl/docs/api/v1/explorer/">OpenAPI</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/payments-and-refunds/">Płatności i zwroty</a><a href="/pl/docs/legal/data-processing/">DPA</a></nav>