API - Interface de formulaire de prospect (F)

Geändert am Do, 12 Jun um 10:44 VORMITTAGS

MELON offre la possibilité de connecter votre formulaire via une requête POST et JSON via API, de sorte que les prospects soient directement répertoriés dans melon et que toutes les informations soient centralisées. Contrairement au formulaire de contact iFrame payant qui offre plus de liberté en termes de conception.

Fonctionnalités disponibles

Clé	Libellé	Valeurs
min_max_miete_0	Montant minimal du loyer brut	Nombre entier
min_max_miete_1	Montant maximal du loyer brut	Nombre entier
min_max_area_0	Superficie minimale	Nombre entier
min_max_area_1	Superficie maximale	Nombre entier
min_max_rooms_0	Nombre minimal de pièces	Nombre décimal
min_max_rooms_1	Nombre maximal de pièces	Nombre décimal
rooms	Nombre de pièces	Nombre décimal
object_type	Type de bien	appartement, artisanat, place de parking, maison, terrain, autres
object_title	Nom du bien	Texte
object_reference_number	Numéro de référence	Texte
household_type	Type de ménage	ménage d'une personne, ménage en couple, ménage en couple avec enfant, ménage monoparental, colocation, autre ménage
title	Civilité	homme, femme, autre genre
firstname	Prénom	Texte
name	Nom	Texte
street_nr	Rue et numéro	Texte
postcode	Code postal	Nombre entier
city	Ville	Texte
phone	Numéro de téléphone	Texte
email	Adresse e-mail	Adresse e-mail
date_of_birth	Date de naissance	Date (AAAA-MM-JJ)
remarks	Remarque / Message	Texte
additional_info	Informations supplémentaires	Texte

URL de l'API et Informations d'Accès

L'interface peut être accédée via l'URL suivante :
melon.new et melon.rent: VOTREPROJET.api.melon.rent/external-data-hook
melon.sale: VOTREPROJET.api.melon.sale/external-data-hook

Pour se connecter à l'interface, des informations d'accès sont nécessaires :
Utilisateur : immoserver
Mot de passe : LWJ7fWHYxHb4cCMQq76w

Format JSON

{"rooms": "3.5",
 "object_type": "apartment",
 "min_max_miete_0": "500",
 "min_max_miete_1": "1500",
 "title": "Herr",
 "firstname": "MELON",
 "name": "Support",
 "street_nr": "Kanzleistr 126",
 "postcode": "8004",
 "city": "Zürich",
 "phone": "0435434416",
 "email": "support@emonitor.ch",
 "remarks": "Bemerkung",
 "object_title": "A01",
 "object_reference_number": "001"
}

Exemple PHP

$data = array(
    'rooms' => $rooms,
    'object_type' => $object_type,
    'household_type' => $household_type,
    'min_max_miete_0' => $min_max_miete_0,
    'min_max_miete_1' => $min_max_miete_1,
    'title' => $title,
    'firstname' => $firstname,
    'name' => $name,
    'street_nr' => $street_nr,
    'postcode' => $postcode,
    'city' => $city,
    'phone' => $phone,
    'email' => $email,
    'remarks' => $remarks,
    'object_title' => $object_title,
    'object_reference_number' => $object_reference_number
);


$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://IHRPROJEKT.api.melon.rent/external-data-hook");
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, 'immoserver:LWJ7fWHYxHb4cCMQq76w');
$response = curl_exec($ch);
curl_close($ch);

Info supplémentaire :
Le numéro de référence est un identifiant unique. Lors de la création d’objets, il faut donc s'assurer que chaque objet possédant un numéro de référence en a un qui soit unique.
La logique utilisée par l'API pour déterminer à quel objet un intéressé doit être attribué est la suivante :

Si la requête contient uniquement le object_title, celui-ci sera utilisé (logique actuelle).
Si la requête contient uniquement le object_reference_number, celui-ci sera utilisé (nouvelle logique).
Si les deux sont présents, le object_reference_number est prioritaire et sera utilisé.