Danh sách kiểm tra trước khi đưa vào hoạt động

Sử dụng danh sách kiểm tra này trước khi bật tích hợp đối tác cho các cơ sở đang hoạt động trên production.

Thiết lập Partner Console

Hồ sơ đối tác của bạn đã đầy đủ.
URL logo, trang web, danh mục và mô tả của bạn chính xác.
Phương thức liên kết dữ liệu của bạn đã được cấu hình: Direct Link hoặc Linking Identifier.
Việc liên kết cơ sở đã được kiểm thử với ít nhất một cơ sở thực tế.
Đang sử dụng đúng loại khóa:
- Dryrun để kiểm thử thao tác ghi mà không gây ảnh hưởng.
- Read-only để sử dụng dữ liệu an toàn.
- Live chỉ khi bạn đã sẵn sàng tác động đến dữ liệu production.

Xác thực và quản lý khóa

Khóa bí mật chỉ được lưu trữ phía máy chủ.
Khóa không được nhúng trong ứng dụng phía máy khách, ứng dụng di động, kho mã công khai hoặc phiếu hỗ trợ.
Việc xoay vòng và thu hồi khóa đã được kiểm thử.
Đội ngũ của bạn biết khóa nào được dùng cho từng môi trường.

Xác thực dữ liệu

Có đầy đủ các trường bắt buộc cho mọi endpoint bạn gọi.
Mã định danh cơ sở khớp với phương thức liên kết đã cấu hình.
ID từ hệ thống của bạn ổn định và không thay đổi giữa các lần đồng bộ.
Các đợt nhập dữ liệu lớn được chia thành các lô dưới giới hạn được nêu trong tài liệu.
Có thể xác định và gửi lại các mục bị lỗi trong lô.

Kiểm thử endpoint

Trước khi ra mắt, hãy kiểm thử mọi endpoint mà tích hợp của bạn phụ thuộc vào:

Có thể đọc thông tin tổ chức và cơ sở.
Có thể lưu và cập nhật hội viên.
Gói hội viên, khu vực ra vào và giờ ra vào được đồng bộ chính xác.
Lượt check-in được chấp nhận và có thể đối chiếu ngược lại với hệ thống của bạn.
Ảnh chụp nhanh báo cáo sử dụng đúng kỳ báo cáo và chỉ số dự kiến.
Các luồng Door/Gate Controller được kiểm thử trên phần cứng thực tế nếu áp dụng.

Sẵn sàng cho Access Time Window

Nếu tích hợp cung cấp Access Time Windows:

Các ví dụ khung thời gian tuyệt đối và hằng tuần vượt qua danh sách kiểm tra chứng nhận dành cho bên tạo dữ liệu.
Giá trị epoch là số nguyên giây Unix không đặt trong dấu ngoặc kép; các ranh giới [from, to) chính xác đã được kiểm thử.
Đã xác minh múi giờ UTC mặc định, các múi giờ IANA tùy chỉnh của tích hợp và các thời điểm chuyển đổi giờ mùa hè liên quan.
Một chuỗi phiên bản bền vững, tăng đơn điệu theo hội viên/nguồn điều phối các bản cập nhật tăng dần, việc đối soát và các lần thử lại.
Người vận hành hiểu hoạt động khi bỏ qua trường, thay thế toàn bộ, idempotent, xung đột, dữ liệu cũ và [] rõ ràng.
Mọi scope_key, bao gồm default, đều có ánh xạ Performance Hub đã được phê duyệt; các khóa không xác định đã được kiểm thử để đảm bảo không được cấp quyền truy cập.
Tần suất làm mới dự kiến, độ cũ tối đa của nguồn, hoạt động khi nguồn đã cũ và các cảnh báo của tích hợp đã được cấu hình.
Đã chứng minh rằng lỗi truy xuất từ upstream không tạo ra ảnh chụp nhanh rỗng hoặc không đầy đủ.
Khả năng hội tụ của chuỗi trên môi trường staging, việc hủy/thu hồi và các ranh giới bắt đầu/kết thúc tại cửa thực tế đạt các mục tiêu đã thống nhất.
Các quy tắc thông thường và quyền cấp vĩnh viễn đã được xác minh là đường dự phòng, và khung thời gian không thể vượt qua việc vô hiệu hóa người dùng, blockAllAccess, chế độ bảo trì hoặc geofencing.

Sẵn sàng cho kiểm soát ra vào

Đối với các tích hợp kiểm soát ra vào:

Hệ thống của bạn đưa ra quyết định ra vào trước khi gọi Performance Hub.
Tích hợp xử lý device_offline, maintenance_mode_active và unlock_confirmation_timeout.
Người vận hành hiểu rằng hết thời gian chờ có nghĩa là việc mở khóa chưa được xác nhận.
Nhật ký của bạn lưu event_id và command_id được trả về.
Bạn có quy trình dự phòng thủ công cho nhân viên cơ sở.

Xử lý lỗi và thử lại

Các phản hồi 400, 401, 403, 404, 409 và 422 được hiển thị cho người vận hành hoặc đội ngũ hỗ trợ thay vì bị thử lại một cách mù quáng.
Các phản hồi 429, 500, 502, 503 và 504 sử dụng logic thử lại có giới hạn với thời gian chờ tăng dần.
Các lỗi lặp lại sẽ tạo cảnh báo trong hệ thống của bạn.
Tích hợp không bao giờ âm thầm bỏ qua các bản ghi bị lỗi.

Khả năng quan sát

Nhật ký của bạn bao gồm endpoint, dấu thời gian, mã định danh cơ sở, ID bản ghi nguồn, kết quả yêu cầu và nội dung phản hồi.
Đội ngũ hỗ trợ của bạn có thể tìm kiếm theo ID hội viên, ID cơ sở, ID check-in hoặc ID sự kiện mở khóa.
Bạn có cách phát lại hoặc đối soát các lần đồng bộ thất bại.

Ra mắt production

Performance Hub đã xác nhận quyền truy cập production của bạn.
Ít nhất một cơ sở trên production đã bật tích hợp của bạn.
Khóa production của bạn đang hoạt động.
Thông tin đầu mối vận hành và kỹ thuật của bạn được cập nhật.
Quy trình hỗ trợ của bạn đã được ghi lại cho khách hàng.

Sau khi hoàn tất các bước kiểm tra này, tích hợp đã cấu hình của bạn sẽ xuất hiện trong danh bạ đối tác của Performance Hub bên trong nền tảng Performance Hub cốt lõi.