Checklist voor livegang

Gebruik deze checklist voordat je een partnerintegratie inschakelt voor faciliteiten in productie.

Configuratie van de Partner Console

Je partnerprofiel is volledig.
Je logo-URL, website, categorie en beschrijving kloppen.
Je koppelmethode voor gegevens is geconfigureerd: Direct Link of Linking Identifier.
De koppeling met faciliteiten is getest met minstens één echte faciliteit.
Het juiste sleuteltype wordt gebruikt:
- Dryrun voor niet-destructieve schrijftests.
- Read-only voor veilig gebruik van gegevens.
- Live alleen wanneer je klaar bent om productiegegevens te beïnvloeden.

Authenticatie en sleutelbeheer

Geheime sleutels worden alleen aan de serverzijde opgeslagen.
Sleutels zijn niet opgenomen in client-side applicaties, mobiele apps, openbare repository's of supporttickets.
Rotatie en intrekking van sleutels zijn getest.
Je team weet welke sleutel in welke omgeving wordt gebruikt.

Gegevensvalidatie

Verplichte velden zijn aanwezig voor elk endpoint dat je aanroept.
Faciliteitidentificaties komen overeen met je geconfigureerde koppelmethode.
ID's uit je systeem zijn stabiel en veranderen niet tussen synchronisaties.
Grote imports worden opgesplitst in batches binnen de gedocumenteerde limieten.
Mislukte items in een batch kunnen worden herkend en opnieuw worden verzonden.

Endpoints testen

Test vóór de lancering elk endpoint waarvan je integratie afhankelijk is:

Organisaties en faciliteiten kunnen worden gelezen.
Leden kunnen worden opgeslagen en bijgewerkt.
Abonnementen, toegangszones en toegangsuren worden correct gesynchroniseerd.
Check-ins worden geaccepteerd en kunnen worden herleid naar je systeem.
Rapportmomentopnamen gebruiken de verwachte rapportageperiode en metrics.
Processen met de Door/Gate Controller zijn waar van toepassing op echte hardware getest.

Gereedheid voor Access Time Windows

Als de integratie Access Time Windows aanlevert:

Absolute en wekelijkse voorbeelden doorstaan de certificeringschecklist voor producenten.
Epochs zijn gehele getallen in Unix-seconden zonder aanhalingstekens; exacte grenzen van [from, to) zijn getest.
UTC-standaarden, de aangepaste IANA-tijdzones van de integratie en relevante overgangen naar en van zomertijd zijn gecontroleerd.
Eén duurzame, monotone revisiereeks per lid/bron coördineert incrementele updates, reconciliatie en nieuwe pogingen.
Beheerders begrijpen het gedrag bij weggelaten, volledig vervangende, idempotente, conflicterende, verouderde en expliciete []-waarden.
Elke scope_key, inclusief default, heeft een goedgekeurde toewijzing in Performance Hub; er is getest dat onbekende sleutels tot weigering leiden (fail-closed).
De verwachte verversingsfrequentie, de maximale leeftijd van brongegevens, het gedrag bij verouderde bronnen en de waarschuwingen van de integratie zijn geconfigureerd.
Er is aangetoond dat een mislukte upstream ophaalactie geen lege of gedeeltelijke momentopname verzendt.
Convergentie van de reeks in de testomgeving, annulering/intrekking en begin- en eindgrenzen bij de fysieke deur voldoen aan de afgesproken doelen.
Reguliere regels en permanente toegangsrechten zijn gecontroleerd als terugvalroutes, en vensters kunnen het uitschakelen van gebruikers, blockAllAccess, onderhoud of geofencing niet omzeilen.

Gereedheid voor toegangsbeheer

Voor integraties met toegangsbeheer:

Je systeem neemt de toegangsbeslissing voordat Performance Hub wordt aangeroepen.
De integratie verwerkt device_offline, maintenance_mode_active en unlock_confirmation_timeout.
Beheerders begrijpen dat een time-out betekent dat de ontgrendeling niet is bevestigd.
Je logboeken bewaren de geretourneerde event_id en command_id.
Je hebt een handmatige terugvalprocedure voor medewerkers van de faciliteit.

Foutafhandeling en nieuwe pogingen

Responses met 400, 401, 403, 404, 409 en 422 worden aan beheerders of supportteams gemeld in plaats van blindelings opnieuw geprobeerd.
Responses met 429, 500, 502, 503 en 504 gebruiken begrensde logica voor nieuwe pogingen met backoff.
Herhaalde fouten leiden tot een waarschuwing in je systeem.
De integratie laat mislukte records nooit stilletjes vallen.

Observeerbaarheid

Je logboeken bevatten het endpoint, de tijdstempel, de faciliteitidentificatie, het bronrecord-ID, de uitkomst van het verzoek en de response-body.
Je supportteam kan zoeken op lid-ID, faciliteit-ID, check-in-ID of ID van de ontgrendelgebeurtenis.
Je kunt mislukte synchronisaties opnieuw afspelen of reconciliëren.

Productielancering

Performance Hub heeft je productietoegang bevestigd.
Minstens één faciliteit in productie heeft je integratie ingeschakeld.
Je productiesleutel is actief.
Je operationele en technische contactpersonen zijn actueel.
Je ondersteuningsproces is voor klanten gedocumenteerd.

Nadat deze controles zijn afgerond, verschijnt je geconfigureerde integratie in de Performance Hub-partnerdirectory binnen het centrale Performance Hub-platform.