</Devcenter Smartvisite™>
⟲ Retour au début

Bienvenue dans le Devcenter Smartvisite™

Que vous soyez le webmaster d'un site d'agence, éditeur de logiciel ou portail d'annonces immobilières, vous trouverez ici les documentations techniques et exemples de code susceptibles de vous faciliter l'intégration de nos produits. Si vous avez des questions, n'hésitez pas à utiliser le formulaire en bas de page.


Site internet d'agence


Logiciel immobilier


Portail d'annonces

connectors_circles
API Smartvisite™

Bien démarrer

Les APIs sont un ensemble d'outil vous permettant d'intégrer facilement nos produits dans vos solutions. Que vous soyez webmaster d'un site agence, éditeur de logiciel ou développeur d'un portail d'annonces, nos APIs vous donneront l'opportunité d'échanger des données avec nos services en toute sécurité. Voici la procédure d'utilisation classique de nos APIs

Flux export + Player iFrame + Data API

Logiciels compatibles

Comme nous venons de le voir, la première étape consiste à exporter vos données (annonces immobilières) vers nos services. Nous sommes déjà intégré dans la majorité des logiciels du marché. Il vous suffit de vous rendre dans la rubrique ”export” puis de sélectionner ”Smartvisite” dans les portails ou services. Ci-dessous, vous trouverez la liste des logiciels avec lesquels vous pouvez déjà faire des exports :

  • AC3 Distribution
  • Abitatvision
  • Activimmo
  • Adaptimmo
  • Agence Plus
  • Alizé
  • Apimo
  • Aptalis
  • Beyat
  • Centris
  • Cybel
  • Chronotech
  • Cosmosoft
  • Ellipse
  • Enova transaction
  • Enova vacances
  • Fnaim
  • Gercop
  • Goventis
  • GPI
  • Hektor
  • Helios
  • Homeresa
  • Horizon
  • Helena
  • Immolog
  • Jviewimmo
  • Lolita
  • Logilink
  • Leximmo
  • Horizon
  • I.C.S
  • Imminence
  • Immostore
  • Immovision
  • Naxos
  • Netty
  • Odyssée
  • Partagimmo
  • Pericles
  • Planitron
  • Elephant Bird
  • Rodacom
  • SDGI
  • Thetrawin
  • Totalimmo
  • Transactimmo
  • Transellis
  • Twimmo
  • Visiteonline
  • Ubiflow
  • Winimmobilier

Si votre logiciel n'est pas listé ci-dessus, nous pouvons nous mettre en relation avec votre éditeur afin de mettre en place une passerelle entre nos services.

Export XML ou CSV

Si vous n'avez pas de logiciel, vous pouvez nous envoyer quotidiennement le flux de vos annonces au format XML sur notre serveur FTP grâce à vos codes d'accès personnels.

icon_doc Demander vos codes d'accès FTP en cliquant ici

Exemple d'export au format XML Smartvisite™

<?xml version="1.0" encoding="UTF-8"?>
<exportsmartvisite date="2013-07-10 12:00">
<agency code="CODE CLIENT">
	<agencyname>NOM DE L'AGENCE</agencyname>
	<agencyaddress1>ADRESSE DE L'AGENCE</agencyaddress1>
	<agencycity>VILLE</agencycity>
	<agencyphone>TELEPHONE</agencyphone>
	<agencyemail>EMAIL</agencyemail>
	<agencypostalcode>CODE POSTAL</agencypostalcode>
	<agencycountry>CODE PAYS</agencycountry>
	<agencywebsite>http://www.sitedelagence.com</agencywebsite>
	<agencylogo>LOGO</agencylogo>	
	<properties>	
	<!-- BOUCLE SUR LES ANNONCES DE L'AGENCE -->
		<property id="CODE ANNONCE" mandat="NUMERO MANDAT">
			<location>
				<address1>ADRESSE</address1>
				<city>VILLE</city>
				<country>CODE ISO</country>
				<postalcode>CODE POSTAL</postalcode>
				<secteur>SECTEUR</secteur>
			</location>
			<agent>
				<id>CODE AGENT</id>
				<firstname>PRENOM</firstname>
				<lastname>NOM</lastname>
				<agentemail>EMAIL</agentemail>
				<officenumber>TELEPHONE BUREAU</officenumber>
				<mobilenumber>TELEPHONE PORTABLE</mobilenumber>
				<photo>URL PHOTO DE L'AGENT (.jpg 250x250px)</photo>
			</agent>
			<propertytype>TYPE DE BIEN</propertytype>
			<transaction>TYPE DE TRANSACTION</transaction>
			<isexclusive>0 ou 1</isexclusive>
			<saleprice currency="EUR" fee="1">PRIX</saleprice>
			<pieces>NOMBRE DE PIECE</pieces>
			<rooms>NOMBRE DE CHAMBRE</rooms>
			<bathrooms>NOMBRE DE SALLE DE BAIN</bathrooms>
			<surface unit="M2">SURFACE EN M2</surface>
			<dpe>DPE EN VALEUR</dpe>
			<ges>GES EN VALEUR</ges>
			<propertytitle><![CDATA[TITRE DU BIEN]]></propertytitle>
			<propertytext><![CDATA[DESCRIPTIF DU BIEN]]></propertytext>
			<propertyphotos>
				<photo caption="TITRE">http://url.com/1.jpg</photo>
				<photo caption="TITRE">http://url.com/2.jpg</photo>
				<photo caption="TITRE">http://url.com/3.jpg</photo>
				[...]
				<photo caption="TITRE">http://url.com/20.jpg</photo>
			</propertyphotos>
			<propertyurl>http://www.sitedelagence.com/bien/</propertyurl>
			<virtual_tour>URL VIDEO OU YOUTUBE</virtual_tour>		
		</property>
	<!-- FIN BOUCLE -->					
	</properties>
</agency>
</exportsmartvisite>

Player iFrame

Le player iFrame vous permet d'intégrer un lecteur vidéo Smartvisite™ sur votre site Internet d'agence ou votre portail. Le Player iFrame est intégré via une balise <iframe> sur votre page. Cette approche offre plus de souplesse car elle permet à Smartvisite™ de servir d'un lecteur HTML5 plutôt que d'un lecteur Flash pour les appareils mobiles qui ne supportent pas Flash.

Vous pouvez récupérer l'URL d'une vidéo d'annonce directement depuis le flux du logiciel dans une balise généralement intitulée ”visite_virtuelle” ou ”video”. Sinon vous pouvez la récupérer en temps réel via ”Data API”.

Nous pouvons aussi sur demande à flux@smartvisite.com, vous exporter quotidiennement un fichier XML sur notre FTP avec les URLs des Spotvidéo™ disponibles.


							<iframe src="http://smrtvst.co/xxxxx?volume=80" width="480"
			height="385" frameborder="0" scrolling="no" AllowFullScreen></iframe>
					

Propriétés

Propriété Type Descriptif
volume
int (3)
Volume du player youtube entre 0 et 100 (défaut : 80)
autostart
booleen
Démarrage automatique de la lecture vidéo (défaut : 0)
autohide
booleen Affichage/masquage de la barre de lecture (défaut : 1)

Taille du lecteur

La taille de l'iFrame pour les vidéos 16:9 sera de 640 x 385 pixels. Pour changer la taille de votre iFrame, changez les paramètres HTML ”width” et ”height” de l'iFrame.

Data API

L'API REST Smartvisite™ vous permet de récupérer les méta-données, les Spotvidéo™ et Sites Mandat relatifs à votre compte. Puisque l'API est basée sur les principes REST, il est très facile d'écrire et de tester des applications. Vous pouvez utiliser votre navigateur pour accéder aux URL, et vous pouvez utiliser à peu près n'importe quel client HTTP dans n'importe quel langage pour interagir avec l'API.

Authentification

Vous devez obtenir une clé d'accès privée pour utiliser l'API Smartvisite™. La clé d'accès est passée avec chaque appel et est utilisée pour l'authentification auprès de l'API Smartvisite™. Elle fournit un accès sécurisé et permet à l'API d'associer chaque demande de votre application à votre compte Smartvisite™. Pour obtenir une clé sous 48h, vous pouvez nous faire la demande via ce formulaire :

icon_doc Demander votre clé API en cliquant ici

URL de base

Voici le schéma standard d'appel vers L'API Smartvisite™, elle est atteignable via HTTPS. HTTP non crypté n'est pas pris en charge afin d'assurer la confidentialité des données.


							https://api.smartvisite.com/{methode}?{propriétés}
						

Propriétés

Propriété Type Description
api_key
string (12)
Votre clé api personnelle (obligatoire)
format
string (3)
Format de sortie (json ou xml, optionnel, défaut : json)
id
string
Token d'une annonce ciblée (optionnel)

Réponses

Toutes les réponses sont des objets JSON. Il y a deux sortes de réponse JSON: «item» et «list». Le type de réponse «item» est un objet JSON avec un seul niveau de paires clé-valeur. Ce type de réponse est utilisé lorsqu'un seul objet est demandé. Le type de réponse «list» est un objet JSON contenant un tableau d'éléments de type «item».

Methodes

GET /videos

Retourne la liste des vidéos disponibles pour votre compte client

Exemple GET

https://api.smartvisite.com/videos?api_key=XXX

Réponse Json

{
  "id": int,
  "token": string,
  "iframeSrc": string,
  "videoSrc": string,
  "listingId": string,
  "propertyNumber": string,
  "videoDetails": string
}							
GET /video

Retourne les informations disponibles sur la vidéo identifiée par ”token”

Exemple :

https://api.smartvisite.com/video?token=XXXXX&api_key=XXX

Réponse Json

{
  "id": int,
  "token": string,
  "snippet": {
    "publishedAt": datetime,
    "youtubeId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string
      }
    }
  },
  "player": {
    "iframeSrc": string,
    "videoSrc": string,
  },
  "statistics": {
    "viewCount": unsigned long,
  },
  "status": {
    "uploadStatus": string,
    "privacyStatus": string
  }
}							
GET /sites

Retourne la liste des Sites Mandat disponibles pour votre compte client

Exemple :

https://api.smartvisite.com/sites?api_key=XXX

Réponse Json

{
  "id": int,
  "url": string,
  "idAgence": string,
  "numeroMandat": string
}							
GET /site

Retourne les informations disponibles sur le Site Mandat identifié par ”id”

Exemple :

https://api.smartvisite.com/site?id=XXX&api_key=XXX

Réponse Json

{
  "id": string,
  "url": string,
  "statistics": {
    "viewCount": unsigned long,
    "likeCount": unsigned long,
  }
}							
GET /user

Retourne la liste des informations disponibles pour votre compte client

Exemple :

https://api.smartvisite.com/user?api_key=XXX

Réponse Json

{
  "id": int,
  "agence": {
    "nom": string,
    "adresse": string,
    "ville": string,
    "cp": int,
    "logo": {
        "url": string
    }
  },
  "urls": {
    "youtube": string,
    "facebook": string,
    "twitter": string,
    "dailymotion": string
  },
  "status": string,
  "creation": datetime
}
							

oEmbed

oEmbed est un protocole ouvert qui permet d’insérer le contenu d’une page web dans une autre page. Le contenu inséré peut être de plusieurs types : photo, vidéo, URL ou extrait HTML. L’échange d’information a lieu entre un site client et un site serveur. Par exemple, le site client peut afficher une représentation d’une page web telle qu’une image ou une vidéo. Le serveur doit disposer d’un service utilisant l’API oEmbed pour permettre aux clients de récupérer les informations de la représentation à afficher.


							https://api.smartvisite.com/oembed?url=http://smrtvst.co/xxxxx
					

Widgets

Voici notre sélection des widgets disponibles pour Facebook et Twitter :

Limites d'utilisation

Nos APIs contiennent certaines limites d'utilisation pour resteindre les abus de ressources. Si vous atteignez ces limites régulièrement, nous pouvons vous proposer différentes solutions payantes dont voici les tarifs.

Appels/jour Appels/jour Appels/jour
Data API 5.000 10.000 20.000
Player iFrame illimité illimité illimité
oEmbed 20.000 40.000 80.000
Gratuit 10€/mois 20€/mois

Aide et support

Si vous avez besoin d'aide et que vous désirez rentrer en contact avec nos équipes techniques, vous pouvez utiliser les commentaires ci-dessous ou bien nous envoyer un email à support@smartvisite.com

Commentaires

comments powered by Disqus