Général
Le plugin WordPress ne fait que faire le pont entre un site Web et le backend RealVuu afin d'aller chercher toutes les données des projets, des bâtiments et des unités, mais permet aussi d'effectuer les recherches dans ces dernières.
L'API est en version 1 actuellement. L'accès se fait toujours par le point d'accès suivant :
PROD
https://api.realvuu.com/plugin/v1
PRE-PROD
https://api-pre-prod.realvuu.com/plugin/v1
DEV
https://api-dev.realvuu.com/plugin/v1
Entêtes (headers)
X-API-Key
Clé privée fournie par l'agence (RealVuu) au client (promoteur immobilier).
X-Real-IP
IP public de l'ordinateur "client" (visiteur sur le web) qui fait la requête. Le IP doit être passé de cette façon car le backend doit enregistrer de quel IP provient chaque requête effectuée.
X-Real-User-Agent
Useragent du navigateur du "client" (visiteur sur le web) qui fait l'accès. Le useragent doit être passé de cette façon car le backend doit enregistrer à partir de quel appareil provient chaque requête effectuée.
X-Visit-ID
ID unique de la visite courante. Lorsque le plugin est utilisé, une visite est toujours créée initialement au chargement de la page Web, et il faut passer ce ID par la suite à chaque requête faite à l'API.
Paramètres de QueryString
culture
Par défaut, la langue détectée est utilisée, ce qui donnera normalement l'anglais dans un call serveur à serveur. Il faut donc passer la langue dans la querystring afin de s'assurer que l'API nous retourne des libellés dans la langue attendue.
Valeurs acceptées : code ISO de langue à 2 positions (fr, en, es, it, etc.)
Ex: ?culture=fr