GET /eco/immo/offres/tags

A propos

Cette requête permet de lister les tags (ou mots-clés) associés à des offres immobilières

Consultez la description du modèle pour plus d'informations.

Limitations

En JSON, la liste des offres est paginée 50 par 50.

Informations

URL https://api.solutions-territoire.fr/eco/immo/offres/tags
Disponibilité 0.10.1
Authentification requise Authorization Code ou Client Credentials
Scope requis Accés aux données économiques
Formats disponibles JSON
Code HTTP attendu 200

Paramètres

page Integer optionnel Numéro de la page de résultat

Réponse

total Integer Nombre de résultats trouvés (toutes pages confondues)
page Integer Numéro de la page selectionnée
tags Array Un tableau des tags utilisés par les offers immobilières

Exemples

Les exemples ci-dessous utilises la variable $ACCESS_TOKEN décrite dans la section Exemple : authentification en ligne de commande.

Exemple de requête listant 50 tags :

cURL :

curl -X GET \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.solutions-territoire.fr/eco/immo/offres/tags

HTTPie :

http -v GET https://api.solutions-territoire.fr/eco/immo/offres/tags \
  Accept:"application/json" \
  Authorization:"Bearer $ACCESS_TOKEN"

Résultat :

GET /eco/immo/offres/statuts HTTP/1.1
Accept: application/json
Authorization: Bearer dGCMv3RWEcgWjgeKS5D6IUw0gv2VKmaPqJzZg9mM_3A

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "total": 42,
    "page":  1,
    "tags":  [
        { "label": "Chambre froide" },
        { "label": "Laboratoires équipés" },
        { "label": "Fibre" },
        { "label": "Cave" },
        [...]
    ]
}