Communication importante – Transition vers HAPI v8

English version below

Cher client,

Dans le cadre de l’évolution continue de nos plateformes technologiques, HOPEM déploiera prochainement la nouvelle version de son API : HAPI v8.

Cette nouvelle version apporte plusieurs améliorations majeures visant à moderniser l’infrastructure technologique de la plateforme et à assurer la pérennité des intégrations pour les prochaines années.

Toutefois, cette évolution introduit également certains changements structuraux pouvant avoir un impact sur les intégrations actuellement en place dans votre environnement.

Nous vous demandons de porter une attention particulière à cette communication et de la transmettre rapidement à votre intégrateur, partenaire technologique ou ressource technique responsable de vos intégrations.

1. Nature des changements introduits dans HAPI v8

La version HAPI v8 introduit une série d’améliorations technologiques importantes découlant notamment :

des évolutions des plateformes Microsoft (.NET),
de la modernisation des standards OData,
de l’optimisation de nos mécanismes de sécurité,
de l’amélioration des performances générales de la plateforme,
et de l’évolution de notre architecture afin de soutenir les besoins futurs.

Ces changements sont nécessaires afin de garantir que la plateforme demeure :

sécuritaire,
performante,
stable,
évolutive,
et conforme aux standards technologiques actuels du marché.

Selon la nature de vos intégrations actuelles, les impacts peuvent varier :

certaines intégrations nécessiteront très peu d’ajustements ;
d’autres pourraient demander des adaptations plus importantes.

Ces changements s’inscrivent dans un processus normal d’évolution technologique d’une plateforme moderne.

2. Responsabilités du client

Votre collaboration avec votre intégrateur est essentielle afin d’assurer une transition fluide vers HAPI v8.

Nous vous demandons de :

Transmettre à votre intégrateur les documents suivants :

HAPI_V8_Breaking_Changes
Documentation HAPI pour intégrateurs
Documentation API Primmo V8
Liens Swagger HAPI v8 (Production et Staging) *Voir lien vers documentation SWAGGER plus bas

Planifier vos travaux de migration :

analyser les impacts sur vos intégrations ;
planifier les ajustements requis ;
coordonner les travaux avec vos partenaires technologiques ;
prévoir les périodes de tests nécessaires avant la mise en production.

3. Déploiement de HAPI v8 et environnements disponibles

Déploiement officiel – Production

La version HAPI v8 sera déployée en production pour l’ensemble des clients le :

15 juillet 2026

URL officielle de production

Production :
https://primmoapi.hopemservices.com/swagger/index.html

Déploiement officiel – Staging

La version HAPI v8 sera déployée en staging pour l’ensemble des clients le :

25 mai 2026

La migration des bases de données staging sera effectuée pour l’ensemble des environnements applicables (certaines exceptions peuvent s’appliquer).

URL staging temporaire

Staging :
https://primmoapistaging-ea.hopemservices.com/swagger/index.html

Cet environnement temporaire vise à permettre une migration progressive ainsi que la réalisation de vos tests avant la mise en production officielle.

4. Programme Early Access

Les clients souhaitant débuter leur migration plus rapidement peuvent adhérer au programme Early Access.

Production Early Access

Le déploiement HAPI v8 en production pourra être activé sur demande avant le déploiement officiel du 15 juillet 2026.

URL Early Access – Production

https://primmoapi-ea.hopemservices.com/swagger/index.html

Demande d’adhésion au programme Early Access

Les demandes peuvent être effectuées à : Envoyer une demande – Hopem

Veuillez préciser :

Gamme : Primmo – Hopem Immobilier
Sujet: HAPI Early Access

5. Environnements de test et stratégies recommandées

Option 1 – Utilisation de votre environnement staging existant

Si vous disposez déjà d’un environnement staging, nous vous recommandons fortement de :

tester vos intégrations avec HAPI v8 ;
valider vos scénarios d’affaires ;
confirmer la compatibilité de vos intégrations avant la mise en production.

Option 2 – Demande d’un environnement staging dédié

Il est possible d’obtenir un environnement staging dédié contenant une copie de vos données de production ainsi qu’un environnement Primmo isolé.

Cet environnement permet :

des tests réalistes ;
une validation complète de vos processus ;
une meilleure préparation de votre migration.

Les environnements staging dédiés sont configurés et maintenus par notre équipe de support technique.

Veuillez communiquer avec votre directeur de compte ou ventes@hopem.com pour obtenir davantage d’informations.

**Des frais peuvent s’appliquer**

Option 3 – Environnement tests partagé

Un environnement de tests partagé sera également disponible.

Cet environnement :

contient des données génériques ;
ne reflète pas votre réalité d’affaires ;
est partagé entre plusieurs clients ;
est réinitialisé quotidiennement ;
sert uniquement à des fins exploratoires ou de validation technique de base.

Cet environnement ne remplace pas un environnement staging dédié.

Pour obtenir les accès :

Les demandes peuvent être effectuées à : Envoyer une demande – Hopem

Veuillez préciser :

Gamme : Primmo – Hopem Immobilier
Sujet: Environnement tests partagé

La collaboration entre votre organisation, vos partenaires technologiques et HOPEM est essentielle afin d’assurer le succès de cette transition.

Nous vous remercions de votre collaboration et vous invitons à entreprendre rapidement les démarches nécessaires avec votre intégrateur afin de planifier adéquatement votre migration vers HAPI v8.

L’équipe HOPEM

Dear Client,

As part of the continuous evolution of our technology platforms, HOPEM will soon deploy the new version of its API: HAPI v8.

This new version introduces several major improvements aimed at modernizing the platform’s technological infrastructure and ensuring the sustainability of integrations for the coming years.

However, this evolution also introduces certain structural changes that may impact integrations currently in place within your environment.

We ask that you pay close attention to this communication and promptly share it with your integrator, technology partner, or the technical resource responsible for your integrations.

1. Nature of Changes Introduced in HAPI v8

HAPI v8 introduces a series of significant technological improvements, including:

advancements in Microsoft platforms (.NET)
modernization of OData standards
optimization of our security mechanisms
improvement of overall platform performance
evolution of our architecture to support future needs

These changes are necessary to ensure the platform remains:

secure
high-performing
stable
scalable
aligned with current market technology standards

Depending on the nature of your current integrations, the impact may vary:

some integrations will require minimal adjustments;
others may require more significant adaptations.

These changes are part of the normal evolution of a modern technology platform.

2. Client Responsibilities

Your collaboration with your integrator is essential to ensure a smooth transition to HAPI v8.

We ask that you:

Share the following documents with your integrator:

*Documents available in French only*

HAPI_V8_Breaking_Changes
HAPI Integrator Documentation
Primmo API V8 Documentation
HAPI v8 Swagger links (Production and Staging)

Plan your migration activities:

analyze the impact on your integrations;
plan the required adjustments;
coordinate work with your technology partners;
schedule the necessary testing phases prior to production deployment.

3. HAPI v8 Deployment and Available Environments

Official Deployment – Production

HAPI v8 will be deployed to production for all clients on:

July 15, 2026

Official Production URL:

Production:
https://primmoapi.hopemservices.com/swagger/index.html

Official Deployment – Staging

HAPI v8 will be deployed to staging for all clients on: May 25, 2026

Staging database migrations will be performed across all applicable environments (some exceptions may apply).

Temporary Staging URL:

Staging:
https://primmoapistaging-ea.hopemservices.com/swagger/index.html

This temporary environment is intended to support progressive migration and allow you to complete testing prior to the official production release.

4. Early Access Program

Clients who wish to begin their migration earlier may join the Early Access program.

Early Access – Production

HAPI v8 can be activated in production upon request prior to the official deployment on July 15, 2026.

Early Access URL – Production:

https://primmoapi-ea.hopemservices.com/swagger/index.html

Requesting Early Access

Requests can be made via: Submit a request – Hopem

Please specify:

Product line: Primmo – Hopem Real Estate
Subject: HAPI Early Access

5. Testing Environments and Recommended Strategies

Option 1 – Use Your Existing Staging Environment

If you already have a staging environment, we strongly recommend that you:

test your integrations with HAPI v8;
validate your business scenarios;
confirm compatibility before production deployment.

Option 2 – Request a Dedicated Staging Environment

You may request a dedicated staging environment containing a copy of your production data along with an isolated Primmo environment.

This environment allows for:

realistic testing;
full validation of your processes;
better preparation for migration.

Dedicated staging environments are configured and maintained by our technical support team.

Please contact your account manager or ventes@hopem.com for more information.

*Additional fees may apply*

Option 3 – Shared Testing Environment

A shared testing environment will also be available.

This environment:

contains generic data;
does not reflect your business reality;
is shared among multiple clients;
is reset daily;
is intended for exploratory use or basic technical validation only.

This environment does not replace a dedicated staging environment.

To request access:

Requests can be made via: Submit a request – Hopem

Please specify:

Product line: Primmo – Hopem Real Estate
Subject: Shared Testing Environment

Collaboration between your organization, your technology partners, and HOPEM is essential to ensure the success of this transition.

We thank you for your cooperation and encourage you to begin the necessary steps with your integrator as soon as possible in order to properly plan your migration to HAPI v8.

The HOPEM Team