Il est aujourd'hui possible sur intentPlatform de créer des comptes utilisateurs par API et de leur attribuer une restriction géographique pour qu'ils n'aient accès qu'à la partie du patrimoine qui les intéressent.
Création du compte utilisateur:
Pour créer un utilisateur, il faut utiliser l'API Users V1.0 avec les informations suivantes :
Le domaine : votre domaine sur intent (en .intent)
Le nom, prénom, adresse mail de l'utilisateur
Un mot de passe par défaut (à la création de ce compte, l'utilisateur recevra un mail automatique de la plateforme l'invitant à réinitialiser ce mot de passe).
Un rôle : user pour des utilisateurs et admin pour un compte administrateur
Vous pouvez également ajouter d'autres champs comme le numéro de téléphone par exemple, liste décrite ici API Users V1.0
POST/users/v1/users
{
"domain":"metropolehabitat.intent",
"firstname":"Victor",
"lastname":"Spagnoli",
"email":"v.spagnoli@intent.fr",
"phone":"0685678893",
"password":"LeMot2p@sse2votreChoix",
"type":"user",
"entityRoles":[
{
"name":"client"
}
],
"userRoles":[
{
"name":"user"
}
]
}
Ajout d'une restriction patrimoniale
Vous souhaitez délimiter le périmètre d'action et d'accès aux données d'un de vos utilisateurs.
Utiliser l'API Users V1.0, faire un GET Users pour récupérer l'identifiant de l'utilisateur à partir de son adresse mail
GET/users/v1/users?email=v.spagnoli@intent.fr
On récupère l'identifiant de l'utilisateur à qui l'on souhaite attribuer une restriction de patrimoine (exemple "id": "4028033451252a9301513385cb55")
Utiliser l'API Users V1.0, faire un POST Geoscopes en indiquant le périmètre géographique auquel il aura accès
POST/users/v1/users/{{userId}}/geoscopes
{
"assetReference":"RES_7653"
}
L'utilisateur aura accès à tous les éléments enfants de la référence de patrimoine que vous aurez attribué à son compte. Vous devez donc indiquer l'élément hiérarchique le plus haut auquel vous souhaitez lui donner accès.
Par exemple, si vous souhaitez que l'utilisateur ait accès aux logements et équipements de la résidence Balmont ayant pour référence "RES_7653", vous devez indiquer "assetReference":"RES_7653" et non l'ensemble des logements et équipements.
Vous pouvez attribuer plusieurs secteurs géographiques pour 1 utilisateur. Pour ceci, il faudra réaliser 1 appel API par secteur géographique que vous souhaitez lui attribuer.