Spécification IT

Du simple partage sécurisé à la plateforme backoffice dédiée

VERIFIMMO s'adapte au niveau de maturité informatique de la régie. On peut commencer sans une ligne de code et monter, au même rythme que vos équipes, jusqu'à un backoffice complet en marque blanche. Cette page donne les considérations générales ; les spécifications détaillées sont remises après identification.

Niveau 01

Partage par lien

Effort : nul · Opérationnel le jour même

Le candidat partage son dossier vérifié vers l'adresse nominative d'un collaborateur. Un lien signé, à durée limitée, ouvre les onze contrôles et les pièces dans le navigateur. Aucun logiciel, aucun compte à créer, sans frais pour la régie.

Secrétariat · gérance

Niveau 02

Adresse VERIFIMMO

Effort : faible · Activable sous 48 heures

Votre page d'accès dans l'enceinte de VERIFIMMO, à l'adresse votreregie.verifimmo.ch : hébergée et personnalisée à votre charte par nos soins. Tous les dossiers partagés à vos collaborateurs s'y retrouvent, sans frais de mise en service et sans intervention de votre côté.

Gérance · direction

Niveau 03

Plateforme de marque

Effort : encadré · Programme sous contrat

La même plateforme, déployée sur votre propre domaine et à votre charte, avec des accès nominatifs. Déploiement conduit avec vous : cadrage, paramétrage, formation des équipes, interlocuteur nommé. Frais de mise en service et abonnement annuel, sur devis.

Direction · marketing

Niveau 04

API dans votre logiciel

Effort : technique · 1 à 2 jours de développement

Le logiciel de gérance lit les dossiers via l'API régie VERIFIMMO v3.2 : trois lectures REST en JSON, une clé au périmètre fermé, pas de webhook obligatoire. Les dossiers apparaissent dans les écrans que vos gérants utilisent déjà.

Informatique · éditeur du CRM

La règle d'accès : une clé ne crée jamais un accès

C'est le seul principe à retenir avant d'écrire une ligne de code : la clé industrialise un accès que le candidat a déjà consenti. Il explique la plupart des réponses 404 rencontrées en production.

Périmètre nominatif

Une clé ne voit que les partages adressés aux adresses e-mail que la régie a déclarées. Aucun paramètre de requête ne peut élargir ce périmètre.

Lecture seule

Deux portées seulement, aucune écriture. L'API ne peut ni modifier un dossier, ni prolonger un partage, ni contacter un candidat.

Tout est journalisé

Chaque lecture de fiche ou de pièce est tracée et visible du candidat, au même titre qu'une consultation humaine.

Mise en route : quatre étapes, dont une seule dépend de nous

01
Le candidat partage son dossier
Rien ne commence par un contrat : c'est le locataire qui décide. Il crée un partage vers l'adresse nominative d'un collaborateur. L'API n'ouvre jamais un accès, elle industrialise un accès déjà consenti.
02
Vous codez en bac à sable
Une clé de démonstration renvoie un dossier fictif complet, aux formats exacts de la production. Vous écrivez votre intégration sans attendre le premier partage réel.
03
Vous demandez la clé de production
Nom de l'enseigne et liste nominative des adresses de vos collaborateurs : nous émettons une clé dont le périmètre est exactement cette liste, avec les portées demandées.
04
Vous remplacez la clé
Même URL, même format de réponse : seule la clé change. Révocation possible à tout moment, sur simple demande.

Sécurité et conformité

Hébergement européen

Données et sauvegardes hébergées en Europe, chez des sous-traitants documentés, dans un cadre conforme au RGPD et à la nLPD.

Chiffrement

TLS 1.3 en transit, chiffrement au repos, pièces servies par URL signée et expirante.

Périmètre fermé

Chaque clé ne voit que les partages qui lui sont adressés. Révocation immédiate.

Journalisation

Chaque consultation de dossier ou de pièce est horodatée et auditable.

Minimisation

Seules les données nécessaires à la décision locative sont transmises.

Réversibilité

Export des données à tout moment, suppression sur demande du candidat.

Architecture en bref

API REST/JSON versionnée, lecture seule côté régie, pagination standard.
Authentification par clé d'API au format vki_<préfixe>_<secret>, hachée côté serveur et révocable.
API hébergée par VERIFIMMO sur un sous-domaine propre à la régie ; portail collaborateurs en marque blanche via un simple CNAME.
Pièces jointes servies par URL signée temporaire, jamais en pièce jointe e-mail.
Environnements de test et de production séparés, clés distinctes.

Questions fréquentes de l'IT

Faut-il ouvrir des ports ou installer un agent ?: Non. Tout passe par HTTPS sortant vers un point d'entrée hébergé par VERIFIMMO.
Combien de temps pour la première intégration ?: Le partage sécurisé est immédiat. L'API se branche typiquement en une à deux journées de développement.
Qui héberge le portail en marque blanche ?: VERIFIMMO. La régie n'a qu'un enregistrement DNS à poser pour garder son nom de domaine.

Pour les informaticiens

Endpoints, schémas de données, codes d'erreur et exemples d'appels

La documentation complète de l'API v3.2 est disponible immédiatement, avec un accès nominatif.

Rappel : Votre Régie .ch est un site fictif de démonstration. Les données affichées sont inventées et aucun appel n'est effectué vers un système de production. L'offre et les tarifs sont présentés sur verifimmo.ch.