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 | Хэвлэлтийн төлөвийн түүх |
{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 статус код.