---
title: "Dokument zum Drucken hochladen"
description: "Laden Sie vor dem Erstellen eines Druckauftrags ein druckfertiges PDF oder explizite RAW-Druckersprachdaten hoch."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Dokument zum Drucken hochladen

<p class="docs-lead">Laden Sie vor dem Erstellen eines Druckauftrags ein druckfertiges PDF oder explizite RAW-Druckersprachdaten hoch.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-post">POST</span><code>/api/v1/documents</code><span><strong>API-Version:</strong> v1</span><span><strong>operationId:</strong> <code>uploadDocument</code></span><a href="/de/docs/api/v1/documents/upload/index.md">Als Markdown anzeigen</a></div>

## Funktion dieser Methode

Laden Sie vor dem Erstellen eines Druckauftrags ein druckfertiges PDF oder explizite RAW-Druckersprachdaten hoch.

## Authentifizierung

Senden Sie ein kurzlebiges Token in `Authorization: Bearer <access_token>`.

**Erforderliche Scopes:** `documents:write`

## Anfrage

**Produktions-URL:** `https://public-api.cloudprint.me/api/v1/documents`

### Parameter

| Name | Position | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- | --- |
| `X-Request-Id` | header | `string` | nein | Optionale Kennung zur Anfrageverfolgung; CloudPrint gibt einen sicheren Wert im Antwort-Header zurück. | maxLength: 128; example: `"order-100045-attempt-1"` |

### Anfrageinhalt

**Inhaltstyp:** `multipart/form-data`

| Name | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- |
| `file` | `string (binary)` | ja | Binäres PDF- oder RAW-Dokument als Multipart-Formulardaten. | — |
| `document_format` | `string \| null` | nein | Explizites Druckformat, beispielsweise `pdf` oder `raw`. | enum: `pdf`, `raw`; example: `"raw"` |
| `document_raw_language` | `string \| null` | nein | Druckerbefehlssprache der RAW-Daten, beispielsweise ZPL oder EPL. | enum: `tspl`, `zpl`, `cpcl`, `escpos`; example: `"zpl"` |

### Anfragebeispiele

#### cURL

```bash
curl -sS https://public-api.cloudprint.me/api/v1/documents \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -F "file=@shipping-label.pdf"
```

## Antwort

**HTTP-Status:** `201` — Ressource erstellt.

### Antwortfelder

| Name | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- |
| `document_id` | `string (uuid)` | ja | Stabile UUID, die nach einem erfolgreichen Dokument-Upload zurückgegeben wird. | — |
| `original_filename` | `string` | ja | Beim Upload gespeicherter ursprünglicher Dateiname. | example: `"invoice.pdf"` |
| `mime_type` | `string` | ja | MIME-Typ der veröffentlichten Installationsdatei oder des gespeicherten Dokuments. | example: `"application/pdf"` |
| `document_format` | `string` | ja | Explizites Druckformat, beispielsweise `pdf` oder `raw`. | enum: `pdf`, `raw`; example: `"pdf"` |
| `document_raw_language` | `string \| null` | ja | Druckerbefehlssprache der RAW-Daten, beispielsweise ZPL oder EPL. | enum: `tspl`, `zpl`, `cpcl`, `escpos`; example: `null` |
| `size_bytes` | `integer` | ja | Größe des gespeicherten Dokuments in Byte. | example: `1024` |

### Beispielantwort

```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
}
```

## Fehler

| HTTP-Status | Beschreibung |
| --- | --- |
| `400` | Prüfen Sie Format und Parameter. |
| `401` | Authentifizierung fehlt oder ist ungültig. |
| `403` | Das Token hat nicht die erforderlichen Berechtigungen. |
| `413` | Der Anfrageinhalt überschreitet die zulässige Größe. |
| `415` | Das Format wird nicht unterstützt. |
| `422` | Mindestens ein Feld ist ungültig. |
| `429` | Anfragelimit überschritten; beachten Sie Retry-After. |
| `500` | Interner CloudPrint-Fehler. |

## Hinweise zur Integration

- PDF ist der Standard. Senden Sie für RAW ausdrücklich `document_format=raw` und `document_raw_language`.
- Konvertieren Sie DOC und DOCX vor dem Upload im Backend in ein druckfertiges PDF.
- Speichern Sie die `document_id` für den Druckauftrag.

## Verwandte Dokumentation

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/documents/"><strong>Dokumente vorbereiten</strong><span>Laden Sie eine druckfertige PDF-Datei oder ausdrücklich gewählte RAW-Daten vor der Auftragserstellung hoch.</span></a>
<a class="docs-card" href="/de/docs/api/v1/print-jobs/create/"><strong>Druckauftrag erstellen</strong><span>Senden Sie ein hochgeladenes Dokument mit Idempotenz und expliziten Druckoptionen an einen ausgewählten Drucker.</span></a>
<a class="docs-card" href="/de/docs/api/v1/print-jobs/create-from-url/"><strong>Druckauftrag aus einer URL erstellen</strong><span>Rufen Sie ein Dokument von einer öffentlichen HTTPS-URL ab und erstellen Sie Dokument und Druckauftrag in einer Anfrage.</span></a></div>

<nav class="docs-resource-links" aria-label="Nächste Schritte"><a href="https://cloudprint.me/status/">Dienststatus</a><a href="/de/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Konto öffnen</a><a href="/docs/legal/privacy/">Datenschutzerklärung</a><a href="/docs/legal/terms/">Nutzungsbedingungen</a><a href="/docs/legal/payments-and-refunds/">Zahlungen und Erstattungen</a><a href="/docs/legal/data-processing/">DPA</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>