Dokumentacja CloudPrint/Dokumentacja API

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 <access_token>.

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

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ź

{
  "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

Przesyłanie dokumentów PDF i RAWWybierz multipart, publiczny adres HTTPS lub Base64 i przygotuj plik PDF albo dane RAW języka drukarki.Utwórz zadanie drukuWyślij przesłany dokument CloudPrint na wybraną drukarkę z idempotencją i jawnymi opcjami.Utwórz zadanie z adresu URLPobierz dokument z publicznego URL HTTPS i jednym żądaniem utwórz dokument oraz zadanie CloudPrint.

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