---
title: "Prześlij dokument do druku"
description: "Prześlij gotowy PDF lub jawne dane RAW języka drukarki przed utworzeniem zadania CloudPrint."
---
# Prześlij dokument do druku
Prześlij gotowy PDF lub jawne dane RAW języka drukarki przed utworzeniem zadania CloudPrint.
POST/api/v1/documentsWersja API: v1operationId:uploadDocumentOtwórz w Markdown
## Działanie metody
Prześlij gotowy PDF lub jawne dane RAW języka drukarki przed utworzeniem zadania CloudPrint.
## Uwierzytelnianie
Przekaż krótkotrwały token w `Authorization: Bearer `.
**Wymagane uprawnienia:** `documents:write`
## Żądanie
**Podstawowy adres API:** `https://public-api.cloudprint.me/api/v1/documents`
### Parametry
Metoda nie ma parametrów ścieżki, zapytania ani dodatkowych nagłówków.
### Treść żądania
**Typ zawartości:** `multipart/form-data`
| Nazwa | Typ | Wymagane | Opis | Ograniczenia |
| --- | --- | --- | --- | --- |
| `file` | `string (binary)` | tak | Binarny dokument PDF lub RAW przesyłany jako multipart form data. | — |
| `document_format` | `string \| null` | nie | Jawny format druku, na przykład `pdf` albo `raw`. | enum: `pdf`, `raw`; example: `"raw"` |
| `document_raw_language` | `string \| null` | nie | Język poleceń danych RAW, na przykład ZPL lub EPL. | enum: `tspl`, `zpl`, `cpcl`, `escpos`; example: `"zpl"` |
### Przykładowe żądania
#### cURL
```bash
curl -sS https://public-api.cloudprint.me/api/v1/documents \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-F "file=@shipping-label.pdf"
```
## Odpowiedź
**Status HTTP:** `201` — Zasób został utworzony.
### Pola odpowiedzi
| Nazwa | Typ | Wymagane | Opis | Ograniczenia |
| --- | --- | --- | --- | --- |
| `document_id` | `string (uuid)` | tak | Stabilny UUID zwracany po pomyślnym przesłaniu dokumentu. | — |
| `original_filename` | `string` | tak | Pole kontraktu API; uwzględnij podany typ i ograniczenia. | example: `"invoice.pdf"` |
| `mime_type` | `string` | tak | Pole kontraktu API; uwzględnij podany typ i ograniczenia. | 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` |
| `size_bytes` | `integer` | tak | Rozmiar zapisanego dokumentu w bajtach. | example: `1024` |
### Przykładowa odpowiedź
```json
{
"document_id": "11111111-1111-4111-8111-111111111111",
"original_filename": "invoice.pdf",
"mime_type": "application/pdf",
"document_format": "pdf",
"document_raw_language": null,
"size_bytes": 1024
}
```
## 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. |
| `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
- PDF jest formatem domyślnym. Dla RAW jawnie wyślij `document_format=raw` i `document_raw_language`.
- Konwertuj DOC i DOCX do gotowego PDF po stronie serwera.
- Zapisz zwrócony `document_id` do żądania utworzenia zadania.
## Powiązana dokumentacja