OpenAPI 3.1
Đặc tả tham chiếu và điểm cuối mẫu.
KIOWARE NHÀ PHÁT TRIỂN CENTER
Webhook và Sự kiện Schema
Mẫu subscription, chữ ký webhook, thử lại, ordering, deduplication và sự kiện lược đồ dữ liệu.
NHÀ PHÁT TRIỂN ASSETS
Tài sản kỹ thuật
Postman
Biến môi trường, xác thực và request mẫu.
Events
Schema, thử lại, deduplication và tương quan.
Acceptance
UAT checklist và bằng chứng nghiệm thu.
BẢO MẬT BASELINE
Quy tắc vận hành chính thức
- Không nhúng secret trong ứng dụng Kiosk
- Mọi lệnh thay đổi trạng thái có idempotency key
- Mọi giao dịch có truy vết/mã tương quan
- Sự kiện consumer phải xử lý duplicate và out-of-order
- Production credential chỉ cấp sau security review
EVENT RELIABILITY
Nguyên tắc xử lý sự kiện đáng tin cậy
Xác thực nguồn
Xác minh chữ ký, timestamp và key version trước khi xử lý.
Chống trùng lặp
Lưu sự kiện ID/idempotency key trong cửa sổ thời hạn lưu giữ phù hợp.
Xử lý sai thứ tự
Dùng aggregate version hoặc sequence khi thứ tự có ý nghĩa.
Phản hồi nhanh
Trả ACK sớm, đưa xử lý nặng sang queue và có dead-letter luồng.
- Sự kiện lược đồ dữ liệu có version và chính sách tương thích ngược.
- Retry chính sách có giới hạn, jitter và ngưỡng cảnh báo.
- Payload không chứa secret và được giảm thiểu dữ liệu cá nhân.
- Mọi sự kiện quan trọng có mã truy vết liên kết với giao dịch gốc.