Uulen Print API

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

Эхлэх

Мерчант бүртгэл үүсгэнэ. Бүртгүүлэх
UulenPrint.exe-г хэвлэгчтэй компьютер дээр суулгаж холбоно. UulenPrint.exe татах
Мерчант самбар → 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	Хэвлэлтийн төлөвийн түүх
POST	/account	Дэд бүртгэл үүсгэх (интегратор)
PATCH	/account	Дэд бүртгэлийг засах
DELETE	/account	Дэд бүртгэлийг устгах
POST	/account/apikey/{description}	Шинэ API түлхүүр
DELETE	/account/apikey/{description}	API түлхүүр цуцлах
POST	/account/pairingcode	Uulen Print програмыг холбох код

{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-өөр татгалзана.

Дэд бүртгэл (интеграторуудад)

Интегратор багцтай бүртгэл өөрийн харилцагч бүрт тусдаа дэд бүртгэл үүсгэж, нэг API түлхүүрээр бүгдийг удирдана. Дэд бүртгэлийн компьютер, хэвлэгч, хэвлэлт бусдаас тусгаарлагдана.

X-Child-Account-By-Id, X-Child-Account-By-Email, X-Child-Account-By-CreatorRef — аль нэгийг нь илгээвэл хүсэлт тухайн дэд бүртгэлийн нэрийн өмнөөс ажиллана.
POST /account/pairingcode-оос авсан кодыг харилцагчийн компьютер дээрх UulenPrint.exe-д оруулна.
Дэд бүртгэлийн хэвлэгчийг тохируулах шаардлагагүй — эхний хэвлэлтээр автоматаар идэвхжинэ.

# 1. Харилцагчдаа дэд бүртгэл үүсгэх
curl -u API_KEY: https://www.uulen.xyz/api/v1/account \
  -H "Content-Type: application/json" \
  -d '{ "Account": { "firstname": "Номин дэлгүүр",
                   "email": "shop42@example.com",
                   "creatorRef": "shop-42" },
        "ApiKeys": ["default"] }'

# 2. Тухайн дэд бүртгэлийн нэрийн өмнөөс холбох код авах
curl -u API_KEY: -X POST https://www.uulen.xyz/api/v1/account/pairingcode \
  -H "X-Child-Account-By-CreatorRef: shop-42"
# → { "code": "K7QM-3XRP", "expiresAt": "..." }

# 3. Дэд бүртгэлийн хэвлэгч рүү хэвлэх
curl -u API_KEY: https://www.uulen.xyz/api/v1/printjobs \
  -H "X-Child-Account-By-CreatorRef: shop-42" \
  -H "Content-Type: application/json" \
  -d '{ "printerId": 31, "contentType": "pdf_uri",
        "content": "https://example.com/label.pdf" }'

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

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

Хуудаслалт

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

Алдаа

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