KIOWARE API TÍCH HỢP CENTER

Tích hợp API KioWare cho ứng dụng, thiết bị và hệ thống doanh nghiệp

Chuẩn hóa việc điều khiển ngoại vi Kiosk, quản lý phiên, bảo mật và bằng chứng qua một lớp middleware ưu tiên API.

API-FIRST KIOSK MIDDLEWARE

Một bề mặt API thống nhất cho ứng dụng và ngoại vi Kiosk

Ứng dụng gọi năng lực nghiệp vụ thay vì gọi trực tiếp trình điều khiển. KioWare Agent thực thi chính sách, hết thời gian chờ, idempotency, che dữ liệu, dữ liệu giám sát và kiểm toán tại biên.

REST / JSONWebSocket EventsmTLSOAuth 2.0 / JWTIdempotencyTrace ID
EDGE API READYv1 · local secure điểm cuối
POST /v1/sessions/{sessionId}/capabilities/identity-card/read
Authorization: Bearer {access_token}
Idempotency-Key: idem-4821
X-KioWare-Policy: BANK-ONBOARDING-V4

{
  "requestId": "REQ-KW-7F2A",
  "deviceRole": "PRIMARY_ID_READER",
  "timeoutMs": 30000,
  "evidenceRequired": true
}
202 ACCEPTEDchính sách-enforcedtraceableno direct trình điều khiển access
CAPABILITY CATALOG

Nhóm API định vị rõ cho đội tích hợp

Phiên API

/v1/sessions

Tạo, khóa, gia hạn, kết thúc và phục hồi phiên có kiểm soát.

Kiểm toán enabled

Thiết bị Năng lực API

/v1/capabilities/{name}

CCCD/NFC, camera, QR, máy in, scanner, signature pad và thiết bị tùy chọn.

HAL normalized

Chính sách API

/v1/policies/evaluate

Phân quyền theo ứng dụng, tenant, phiên, thiết bị và trạng thái rủi ro.

Least privilege

Telemetry API

/v1/events/stream

Sự kiện thiết bị, tiến trình giao dịch, sức khỏe, SLA và cảnh báo.

Near real-time

Bằng chứng API

/v1/evidence

Biên nhận, truy vết, sự đồng ý reference và bằng chứng kiểm toán.

Integrity protected

Admin API

/internal/v1/fleet

Inventory, desired trạng thái, phát hành ring, lệnh và phục hồi.

Control plane
REFERENCE ARCHITECTURE

Bốn góc nhìn cho CTO và kiến trúc sư

Business ChannelWeb application, native application, luồng nghiệp vụ và service journey.
KioWare AgentPhiên manager, thực thi chính sách, secure storage, sự kiện bus và phục hồi checkpoint.
HAL / Bộ chuyển đổiNăng lực abstraction, trình điều khiển isolation, calibration và thiết bị attestation.
Trust ServicesSSO, sự đồng ý, xác thực tăng cường authentication, remote signing và bằng chứng.
Edge NodeKiosk bộ thực thi, local-only API, offline chính sách cache và encrypted temporary dữ liệu.
Secure ChannelOutbound mTLS, signed lệnh, TTL và không mở cổng inbound công khai.
Trung tâm điều khiểnFleet inventory, tenant, phát hành, dữ liệu giám sát, sự cố và kiểm toán.
Identity BoundaryUser danh tính, application danh tính và thiết bị danh tính được xác minh độc lập.
Chính sách BoundaryLeast privilege, che dữ liệu, maker-checker và short-lived authorization.
Bằng chứng BoundaryTrace ID, sự đồng ý reference, immutable kiểm toán và thời hạn lưu giữ chính sách.
Desired StateConfiguration baseline, drift detection, canary và quay lui.
Remote Vận hànhCommand queue, expiry, idempotency, approval và sự cố phản hồi.
ContinuityGolden image, backup, phục hồi mode, failover và DR testing.
TÍCH HỢP JOURNEY

Từ workshop đến vận hành chính thức có tiêu chí nghiệm thu

01

Discovery

Use case, thiết bị, dữ liệu, SLA và security ranh giới.

02

Môi trường thử nghiệm

ứng dụng danh tính, chính sách profile, sample app và kiểm thử thiết bị.

03

Build

API/SDK, bộ kết nối, bộ chuyển đổi và sự kiện đặc tả.

04

Bảo mật

Threat review, negative tests, phục hồi và kiểm toán.

05

UAT

Luồng thành công, exception, hiệu năng, accessibility và bằng chứng.

06

Scale

Pilot, phát hành ring, dữ liệu giám sát, SLA và handover.

FAQ

Câu hỏi về tích hợp API KioWare

KioWare có bắt buộc ứng dụng gọi trực tiếp trình điều khiển không?

Không. Ứng dụng gọi năng lực chuẩn hóa qua KioWare Agent; Thiết bị Bộ chuyển đổi cô lập SDK và trình điều khiển của nhà sản xuất.

Có thể triển khai API trong mạng nội bộ không?

Có. Edge API có thể được giới hạn tại Kiosk hoặc site network; mô hình kết nối Control Plane tùy theo Tại chỗ, Kết hợp hoặc Được quản lý Service.

KioWare hỗ trợ những thiết bị nào?

Phạm vi tiêu chuẩn gồm CCCD/NFC, camera, QR/barcode, máy in, scanner, cảm ứng, loa/micrô; thiết bị bổ sung được tích hợp qua Thiết bị Bộ chuyển đổi.

Làm thế nào để đăng ký sandbox?

Doanh nghiệp gửi tình huống sử dụng, thiết bị và hệ thống hệ thống phía sau. Mobile-ID rà soát rồi cấp app danh tính, chính sách profile và kế hoạch PoC/UAT.

TRAO ĐỔI ĐIỀU HÀNH · HỘI THẢO KỸ THUẬT

Chuyển yêu cầu Kiosk thành phạm vi có thể nghiệm thu

Đánh giá TCO, API, HAL, IAM, thiết bị ngoại vi, PoC, UAT và lộ trình vận hành chính thức với đội KioWare.