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.
  • default dahil her scope_key onaylanmış 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ı, blockAllAccess ayarı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_active ve unlock_confirmation_timeout durumları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_id ve command_id değerlerini saklıyor.
  • Tesis personeli için manuel bir yedek süreciniz var.

Hata işleme ve yeniden denemeler

  • 400, 401, 403, 404, 409 ve 422 yanıtları körü körüne yeniden denenmek yerine operatörlere veya destek ekiplerine iletiliyor.
  • 429, 500, 502, 503 ve 504 yanı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.