ХҮҮүлэн Хэвлэл

Uulen Print API

PrintNode API-тай нийцтэй. Одоо байгаа PrintNode кодоо хаягаа солиод ашиглаж болно.

Эхлэх

  1. Мерчант бүртгэл үүсгэнэ. Бүртгүүлэх
  2. UulenPrint.exe-г хэвлэгчтэй компьютер дээр суулгаж холбоно. UulenPrint.exe татах
  3. Мерчант самбар → Uulen Print хэсгээс API түлхүүр үүсгэнэ. API түлхүүрүүд

Нэвтрэлт

HTTP Basic: API түлхүүр нь хэрэглэгчийн нэр, нууц үг хоосон.

Үндсэн хаяг: https://www.uulen.xyz/api/v1

Endpoint-ууд

GET/whoamiБүртгэлийн мэдээлэл
GET/pingХолболт шалгах
GET/computers[/{set}]Холбогдсон компьютерууд
GET/computers/{set}/printers[/{set}]Компьютерын хэвлэгчид (id эсвэл нэрээр)
GET/printers[/{set}]Бүх хэвлэгч
GET/printers/{set}/printjobs[/{set}]Хэвлэгчийн хэвлэлтүүд
DELETE/printers/{set}/printjobs[/{set}]Хэвлэгчийн хүлээгдэж буй хэвлэлтийг цуцлах
POST/printjobsШинэ хэвлэлт үүсгэх
GET/printjobs[/{set}]Хэвлэлтүүд
DELETE/printjobs[/{set}]Хүлээгдэж буй хэвлэлтийг цуцлах
GET/printjobs[/{set}]/statesХэвлэлтийн төлөвийн түүх

{set} = 1 эсвэл таслалаар тусгаарласан хэд хэдэн id, ж: 12,15,19

Жишээ: PDF хэвлэх

contentType: pdf_uri, pdf_base64, raw_uri, raw_base64

curl -u API_KEY: https://www.uulen.xyz/api/v1/printjobs \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: order-1042" \
  -d '{
    "printerId": 12,
    "title": "Захиалга #1042",
    "contentType": "pdf_base64",
    "content": "JVBERi0xLjQK...",
    "options": { "copies": 2, "duplex": "long-edge" }
  }'

# → 201  1873   (шинэ хэвлэлтийн id)

POST /printjobs дээр X-Idempotency-Key толгой илгээвэл 24 цагийн дотор давхардсан хэвлэлтийг 409-өөр татгалзана.

Хэвлэлтийн төлөв

  • new Хүлээн авсан
  • sent_to_client Компьютер рүү илгээсэн
  • done Хэвлэсэн
  • error Алдаа
  • deleted Цуцалсан

Хуудаслалт

Жагсаалтууд limit (анх 100, дээд 1000), after (id), dir (asc | desc, анх desc) параметр авна.

Алдаа

Алдааны хариу: { uid, code, message } ба HTTP статус код.