Logo Performance HubPerformance Hub
Bagian situs: Sumber Daya Developer & Mitra

Daftar Periksa Go-Live

Gunakan daftar periksa ini sebelum mengaktifkan integrasi mitra untuk fasilitas produksi.

Penyiapan Partner Console

  • Profil mitra Anda sudah lengkap.
  • URL logo, situs web, kategori, dan deskripsi Anda sudah akurat.
  • Metode penautan data Anda sudah dikonfigurasi: Direct Link atau Linking Identifier.
  • Penautan fasilitas telah diuji dengan setidaknya satu fasilitas nyata.
  • Jenis kunci yang digunakan sudah tepat:
    • Dryrun untuk pengujian tulis yang tidak merusak.
    • Read-only untuk konsumsi data yang aman.
    • Live hanya saat Anda siap memengaruhi data produksi.

Autentikasi dan pengelolaan kunci

  • Kunci rahasia hanya disimpan di sisi server.
  • Kunci tidak disematkan di aplikasi sisi klien, aplikasi seluler, repositori publik, atau tiket dukungan.
  • Rotasi dan pencabutan kunci telah diuji.
  • Tim Anda mengetahui kunci mana yang digunakan oleh setiap lingkungan.

Validasi data

  • Bidang wajib tersedia untuk setiap endpoint yang Anda panggil.
  • Pengidentifikasi fasilitas sesuai dengan metode penautan yang Anda konfigurasi.
  • ID dari sistem Anda stabil dan tidak berubah di antara sinkronisasi.
  • Impor besar dibagi menjadi batch di bawah batas yang didokumentasikan.
  • Item batch yang gagal dapat diidentifikasi dan dikirim ulang.

Pengujian endpoint

Sebelum peluncuran, uji setiap endpoint yang menjadi tumpuan integrasi Anda:

  • Organisasi dan fasilitas dapat dibaca.
  • Anggota dapat disimpan dan diperbarui.
  • Paket keanggotaan, zona akses, dan jam akses tersinkronisasi dengan benar.
  • Check-in diterima dan dapat dikaitkan kembali ke sistem Anda.
  • Snapshot laporan menggunakan periode pelaporan dan metrik yang diharapkan.
  • Alur Door/Gate Controller telah diuji pada perangkat keras nyata jika berlaku.

Kesiapan Access Time Window

Jika integrasi menyediakan Access Time Windows:

  • Contoh absolut dan mingguan lolos daftar periksa sertifikasi produsen.
  • Epoch berupa bilangan bulat detik Unix tanpa tanda kutip; batas [from, to) yang tepat telah diuji.
  • Default UTC, zona waktu IANA kustom integrasi, dan transisi waktu musim panas yang relevan telah diverifikasi.
  • Satu aliran revisi anggota/sumber yang tahan lama dan monoton mengoordinasikan pembaruan inkremental, rekonsiliasi, dan percobaan ulang.
  • Operator memahami perilaku untuk nilai yang dihilangkan, penggantian lengkap, idempoten, bertentangan, usang, dan [] eksplisit.
  • Setiap scope_key, termasuk default, memiliki pemetaan Performance Hub yang disetujui; kunci yang tidak dikenal telah diuji untuk memastikan akses ditolak.
  • Frekuensi pembaruan yang diharapkan, usia sumber maksimum, perilaku saat sumber usang, dan peringatan untuk integrasi telah dikonfigurasi.
  • Telah dibuktikan bahwa kegagalan pengambilan dari upstream tidak menghasilkan snapshot kosong atau parsial.
  • Konvergensi aliran staging, pembatalan/pencabutan, serta batas awal/akhir pada pintu fisik memenuhi target yang disepakati.
  • Aturan reguler dan izin permanen telah diverifikasi sebagai jalur cadangan, dan jendela tidak dapat melewati penonaktifan pengguna, blockAllAccess, pemeliharaan, atau geofencing.

Kesiapan kontrol akses

Untuk integrasi kontrol akses:

  • Sistem Anda membuat keputusan akses sebelum memanggil Performance Hub.
  • Integrasi menangani device_offline, maintenance_mode_active, dan unlock_confirmation_timeout.
  • Operator memahami bahwa batas waktu berarti pembukaan kunci tidak dikonfirmasi.
  • Log Anda menyimpan event_id dan command_id yang dikembalikan.
  • Anda memiliki proses cadangan manual untuk staf fasilitas.

Penanganan kesalahan dan percobaan ulang

  • Respons 400, 401, 403, 404, 409, dan 422 ditampilkan kepada operator atau tim dukungan, bukan dicoba ulang secara membabi buta.
  • Respons 429, 500, 502, 503, dan 504 menggunakan logika percobaan ulang terbatas dengan backoff.
  • Kegagalan berulang memicu peringatan di sistem Anda.
  • Integrasi tidak pernah membuang rekaman yang gagal secara diam-diam.

Observabilitas

  • Log Anda mencakup endpoint, stempel waktu, pengidentifikasi fasilitas, ID rekaman sumber, hasil permintaan, dan isi respons.
  • Tim dukungan Anda dapat mencari berdasarkan ID anggota, ID fasilitas, ID check-in, atau ID peristiwa buka kunci.
  • Anda memiliki cara untuk memutar ulang atau merekonsiliasi sinkronisasi yang gagal.

Peluncuran produksi

  • Performance Hub telah mengonfirmasi akses produksi Anda.
  • Setidaknya satu fasilitas produksi telah mengaktifkan integrasi Anda.
  • Kunci produksi Anda aktif.
  • Kontak operasional dan teknis Anda sudah diperbarui.
  • Proses dukungan Anda telah didokumentasikan untuk pelanggan.

Setelah pemeriksaan ini selesai, integrasi yang telah Anda konfigurasi akan muncul di direktori mitra Performance Hub di dalam platform inti Performance Hub.