NHÀ PHÁT TRIỂN QUICK START
KioWare Nhà phát triển Bắt đầu nhanh
Hướng dẫn tham chiếu 15 phút để tạo phiên, khám phá năng lực, gửi lệnh có idempotency và nhận sự kiện từ KioWare.
15-MINUTE QUICK START1. Nhận quyền truy cậpYêu cầu sandbox và app danh tính. 2. Tạo phiênGắn Kiosk, app, locale và chính sách. 3. Khám phá năng lựcĐọc trạng thái reader/printer/camera. 4. Gửi lệnhDùng hết thời gian chờ và idempotency key. 5. Nhận sự kiệnĐối chiếu truy vết/mã tương quan. 6. Thu hồiKết thúc phiên và kiểm tra kiểm toán.
Mục tiêu của hướng dẫn tham chiếu
Tạo một phiên thử, kiểm tra năng lực thiết bị và gửi một lệnh có idempotency. Endpoint và payload là preview để thảo luận kiến trúc; không phải thông tin vận hành chính thức.
REQUEST EXAMPLE
Tạo phiên thử
bash
curl -X POST https://sandbox.example.internal/v1/sessions \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: demo-001" \
-d '{"kioskId":"KSK-DEMO-01","applicationId":"app-demo","locale":"vi-VN"}' Không dùng URL mẫu ở vận hành chính thức. Host, authentication, scopes và lược đồ dữ liệu được cấp theo dự án.
BẢO MẬT CHECK
Trước khi chuyển từ sandbox sang UAT
- mTLS / mã thông báo lifecycle / secret storage
- Scope và least privilege
- Hết thời gian chờ, thử lại và idempotency
- Che dữ liệu, logging và bằng chứng
- Versioning, quay lui và sự cố contact