---
title: "Загрузить документ для печати"
description: "Загрузите готовый PDF или явные RAW-команды языка принтера перед созданием задания CloudPrint."
---
# Загрузить документ для печати
Загрузите готовый PDF или явные RAW-команды языка принтера перед созданием задания CloudPrint.
POST/api/v1/documentsВерсия API: v1operationId:uploadDocumentОткрыть в Markdown
## Назначение метода
Загрузите готовый PDF или явные RAW-команды языка принтера перед созданием задания CloudPrint.
## Авторизация
Передавайте короткоживущий токен в `Authorization: Bearer `.
**Обязательные разрешения:** `documents:write`
## Запрос
**Основной адрес API:** `https://public-api.cloudprint.me/api/v1/documents`
### Параметры
У метода нет параметров пути, строки запроса или дополнительных заголовков.
### Тело запроса
**Тип содержимого:** `multipart/form-data`
| Имя | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- |
| `file` | `string (binary)` | да | Бинарный PDF- или RAW-документ в multipart form data. | — |
| `document_format` | `string \| null` | нет | Явный формат печати, например `pdf` или `raw`. | enum: `pdf`, `raw`; example: `"raw"` |
| `document_raw_language` | `string \| null` | нет | Язык команд RAW-документа, например ZPL или EPL. | enum: `tspl`, `zpl`, `cpcl`, `escpos`; example: `"zpl"` |
### Примеры запросов
#### cURL
```bash
curl -sS https://public-api.cloudprint.me/api/v1/documents \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-F "file=@shipping-label.pdf"
```
## Ответ
**HTTP-статус:** `201` — Ресурс создан.
### Поля ответа
| Имя | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- |
| `document_id` | `string (uuid)` | да | Стабильный UUID, возвращаемый после успешной загрузки документа. | — |
| `original_filename` | `string` | да | Поле контракта API; учитывайте указанные тип и ограничения. | example: `"invoice.pdf"` |
| `mime_type` | `string` | да | Поле контракта API; учитывайте указанные тип и ограничения. | example: `"application/pdf"` |
| `document_format` | `string` | да | Явный формат печати, например `pdf` или `raw`. | enum: `pdf`, `raw`; example: `"pdf"` |
| `document_raw_language` | `string \| null` | да | Язык команд RAW-документа, например ZPL или EPL. | enum: `tspl`, `zpl`, `cpcl`, `escpos`; example: `null` |
| `size_bytes` | `integer` | да | Размер сохранённого документа в байтах. | example: `1024` |
### Пример ответа
```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
}
```
## Ошибки
| HTTP-статус | Описание |
| --- | --- |
| `400` | Проверьте формат и параметры запроса. |
| `401` | Авторизация отсутствует или недействительна. |
| `403` | Для операции недостаточно разрешений. |
| `413` | Тело запроса превышает допустимый размер. |
| `415` | Формат содержимого не поддерживается. |
| `422` | Поля запроса не прошли проверку. |
| `429` | Превышен лимит запросов; учитывайте Retry-After. |
| `500` | Внутренняя ошибка CloudPrint. |
## Рекомендации по интеграции
- PDF используется по умолчанию. Для RAW явно передавайте `document_format=raw` и `document_raw_language`.
- Конвертируйте DOC и DOCX в готовый к печати PDF на своей серверной стороне.
- Сохраните возвращённый `document_id` для запроса создания задания.
## Связанная документация