Yayına geçiş kontrol listesi
Bir iş ortağı entegrasyonunu üretimdeki tesisler için etkinleştirmeden önce bu kontrol listesini kullanın.
Partner Console kurulumu
- İş ortağı profiliniz eksiksiz.
- Logo URL'niz, web siteniz, kategoriniz ve açıklamanız doğru.
- Veri bağlama yönteminiz yapılandırılmış: Direct Link veya Linking Identifier.
- Tesis bağlama en az bir gerçek tesisle test edilmiş.
- Doğru anahtar türü kullanılıyor:
- Yıkıcı olmayan yazma testleri için Dryrun.
- Güvenli veri kullanımı için Read-only.
- Yalnızca üretim verilerini etkilemeye hazır olduğunuzda Live.
Kimlik doğrulama ve anahtar yönetimi
- Gizli anahtarlar yalnızca sunucu tarafında saklanıyor.
- Anahtarlar istemci tarafı uygulamalara, mobil uygulamalara, herkese açık depolara veya destek taleplerine gömülmüyor.
- Anahtar döndürme ve iptal etme test edilmiş.
- Ekibiniz her ortamda hangi anahtarın kullanıldığını biliyor.
Veri doğrulama
- Çağırdığınız her uç nokta için zorunlu alanlar mevcut.
- Tesis tanımlayıcıları yapılandırdığınız bağlama yöntemiyle eşleşiyor.
- Sisteminizdeki kimlikler sabit ve eşitlemeler arasında değişmiyor.
- Büyük içe aktarmalar belgelenen sınırların altındaki toplu işlemlere bölünüyor.
- Başarısız toplu işlem öğeleri belirlenip yeniden gönderilebiliyor.
Uç nokta testi
Lansmandan önce entegrasyonunuzun bağlı olduğu her uç noktayı test edin:
- Organizasyonlar ve tesisler okunabiliyor.
- Üyeler kaydedilip güncellenebiliyor.
- Üyelik planları, erişim alanları ve erişim saatleri doğru şekilde eşitleniyor.
- Check-in'ler kabul ediliyor ve sisteminizle ilişkilendirilebiliyor.
- Rapor anlık görüntüleri beklenen raporlama dönemini ve ölçümleri kullanıyor.
- Door/Gate Controller akışları, uygun olduğu durumlarda gerçek donanım üzerinde test edilmiş.
Access Time Window hazırlığı
Entegrasyon Access Time Windows sağlıyorsa:
- Mutlak ve haftalık örnekler üretici sertifikasyon kontrol listesinden geçiyor.
- Epoch değerleri tırnaksız tam sayı Unix saniyeleri; tam
[from, to)sınırları test edilmiş. - UTC varsayılanları, entegrasyonun özel IANA saat dilimleri ve ilgili yaz saati geçişleri doğrulanmış.
- Tek bir kalıcı, tekdüze üye/kaynak revizyon akışı artımlı güncellemeleri, mutabakatı ve yeniden denemeleri koordine ediyor.
- Operatörler; gönderilmeyen, tamamen değiştirilen, idempotent, çakışan, eski ve açık
[]davranışlarını anlıyor. defaultdahil herscope_keyonaylanmış bir Performance Hub eşlemesine sahip; bilinmeyen anahtarların kapalı başarısız olduğu (fail closed) test edilmiş.- Entegrasyonun beklenen yenileme sıklığı, maksimum kaynak yaşı, eski kaynak davranışı ve uyarıları yapılandırılmış.
- Bir üst kaynak sorgu hatasının boş veya kısmi bir anlık görüntü göndermediği kanıtlanmış.
- Aşamalı akış yakınsaması, iptal/geri alma ve fiziksel kapı başlangıç/bitiş sınırları kararlaştırılan hedefleri karşılıyor.
- Normal kurallar ve kalıcı izinler yedek yollar olarak doğrulanmış ve pencereler kullanıcı devre dışı bırakmayı,
blockAllAccessayarını, bakımı veya coğrafi sınırlamayı (geofencing) atlayamıyor.
Erişim denetimi hazırlığı
Erişim denetimi entegrasyonları için:
- Sisteminiz Performance Hub'ı çağırmadan önce erişim kararını veriyor.
- Entegrasyon
device_offline,maintenance_mode_activeveunlock_confirmation_timeoutdurumlarını ele alıyor. - Operatörler, zaman aşımının kilit açmanın onaylanmadığı anlamına geldiğini anlıyor.
- Kayıtlarınız döndürülen
event_idvecommand_iddeğerlerini saklıyor. - Tesis personeli için manuel bir yedek süreciniz var.
Hata işleme ve yeniden denemeler
400,401,403,404,409ve422yanıtları körü körüne yeniden denenmek yerine operatörlere veya destek ekiplerine iletiliyor.429,500,502,503ve504yanıtları geri çekilmeli, sınırlı yeniden deneme mantığı kullanıyor.- Tekrarlanan hatalar sisteminizde bir uyarı oluşturuyor.
- Entegrasyon başarısız kayıtları hiçbir zaman sessizce düşürmüyor.
Gözlemlenebilirlik
- Kayıtlarınız uç noktayı, zaman damgasını, tesis tanımlayıcısını, kaynak kayıt kimliğini, istek sonucunu ve yanıt gövdesini içeriyor.
- Destek ekibiniz üye kimliğine, tesis kimliğine, check-in kimliğine veya kilit açma olay kimliğine göre arama yapabiliyor.
- Başarısız eşitlemeleri yeniden oynatmanın veya mutabakatını sağlamanın bir yolu var.
Üretime geçiş
- Performance Hub üretim erişiminizi onaylamış.
- En az bir üretim tesisi entegrasyonunuzu etkinleştirmiş.
- Üretim anahtarınız etkin.
- Operasyonel ve teknik irtibat kişileriniz güncel.
- Destek süreciniz müşteriler için belgelenmiş.
Bu kontroller tamamlandıktan sonra, yapılandırdığınız entegrasyon temel Performance Hub platformundaki Performance Hub iş ortağı dizininde görünür.