Récupérer le contact d'un logement ou d'un bâtiment

Vous souhaitez récupérer le contact d'un logement pour mettre à jour la fiche d'un logement, planifier une intervention ou compléter les informations d'une demande d'intervention, vous pouvez le faire en réalisant un appel API sur l'élément de patrimoine concerné.

Méthodes

GET /assets/v2/assets/{référence}?ownerId={id}
Vous avez besoin de la référence de l'asset sur lequel vous souhaitez récupérer le contact et l'id du propriétaire de l'élément de patrimoine.

Le contact ou les contacts sont localisés dans le champ intent_contacts de la rubrique tags. Ils sont au format vCard.

Nous récupérons le contact pour le logement DM-logement-23
GET /api/assets/v2/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6

{
    "category": "Lot",
    "code": "part_23",
    "fullPath": "/lyon_centreest/ag_lyon/site_5/part_23",
    "label": "logement 23",
    "tags": {
        "intent_type": "dwelling",
        "intent_address_way": "41 rue du Souvenir",
        "intent_address_zip": "69009",
        "intent_address_city": "Lyon",
        "intent_latitude": 45.7755341,
        "intent_longitude": 4.7896022,
        "etage": "r+3",
        "porte": "3",
        "typologie": "F2",
        "catégorie_financement": "PLA",
        "note_dpe": "classe_D",
        "temoin_ascenseur": "ascenseur",
        "intent_contacts": "BEGIN:VCARD\r\nVERSION:3.0\r\nFN;CHARSET=UTF-8:COLETTE SPAGNOLI \r\nN;CHARSET=UTF-8:SPAGNOLI ;COLETTE;;;\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:c.spagnoli@thisisafakemail.com\r\nROLE;CHARSET=UTF-8:Locataire\r\nREV:2023-11-13T15:53:08+01:00\r\nEND:VCARD"
    },
    "type": "building",
    "owner": {
        "id": "5ba2123b582f7860c68de6f6",
        "label": "La Métropole de l'Habitat",
        "entityRoles": [
            {
                "name": "client"
            },
            {
                "name": "developer"
            },
            {
                "name": "assetOwner"
            }
        ],
        "logoUrl": "https://hubintent.com/intent/entities/logos/6b98a47a-64ad-4362-9ae8-a9a332be3d1f.png"
    },
    "contracts": [
        "Multiservice_Ag_Lyon",
        "Bon_de_commande",
        "Diagnostic_amiante",
        "Comptage_Ag_Lyon",
        "Multiservice_BDC",
        "EV2023",
        "TEST_IDEX",
        "123456"
    ],
    "metadata": {
        "position": {
            "type": "Point",
            "coordinates": [
                4.7896022,
                45.7755341
            ]
        }
    },
    "reference": "DM-logement-23",
    "parentPath": "/lyon_centreest/ag_lyon/site_5",
    "lastUpdateDate": "2024-05-28T16:10:39+02:00",
    "creationDate": "2018-09-24T17:16:26+02:00",
    "_links": {
        "self": {
            "href": "https://api.hubintent.com/api/assets/v2/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6"
        },
        "operations:list": {
            "href": "https://api.hubintent.com/api/operations/v2/operations?ancestorAssetReference=DM-logement-23&ancestorAssetOwnerId=5ba2123b582f7860c68de6f6"
        },
        "streams:list": {
            "href": "https://api.hubintent.com/api/data/v1/streams?ancestorAssetReference=DM-logement-23&ancestorAssetOwnerId=5ba2123b582f7860c68de6f6"
        },
        "documents:list": {
            "href": "https://api.hubintent.com/api/documents/v1/documents?ancestorAssetReference=DM-logement-23&ancestorAssetOwnerId=5ba2123b582f7860c68de6f6"
        },
        "share": {
            "href": "https://api.hubintent.com/api/assets/v1/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6"
        },
        "update:installation_path": {
            "href": "https://api.hubintent.com/api/assets/v1/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6"
        },
        "migrate": {
            "href": "https://api.hubintent.com/api/assets/v1/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6"
        }
    }
}