API — Endpoint projects/list

Portée requise : projects:read (flux « Application OAuth ») ou project:read (flux partenaire).

Renvoie, pour chaque projet accessible à votre jeton, ses informations générales ainsi que le statut de chaque étape et sous-étape du projet (current, completed, disabled, ...). Chaque étape et sous-étape porte aussi son nom en français, anglais et espagnol (name_fr, name_en, name_es) — vide pour une étape hors du parcours standard.

Le champ possession indique le taux de possession de l'utilisateur du jeton sur ce projet (utile pour un bien à plusieurs propriétaires). Il vaut null pour un jeton partenaire (client_credentials, non rattaché à un utilisateur) ou si cet utilisateur ne fait pas partie des propriétaires du projet.

Le pays est fourni sous deux formes : country (id numérique historique) et country_iso / country_name_fr / country_name_en / country_name_es — vides si l'id ne correspond à aucun des 3 pays actuellement installés (Cameroun, France, Sénégal).

curl https://construction.my-smartlife.fr/api/projects/list \
  -H 'Authorization: Bearer VOTRE_ACCESS_TOKEN'

Exemple de réponse :

{
  "projects": [
    {
      "id": "12",
      "name": "Résidence Les Palmiers",
      "city": "Abidjan",
      "country": 1,
      "country_iso": "FR",
      "country_name_fr": "France",
      "country_name_en": "France",
      "country_name_es": "Francia",
      "currency": "XOF",
      "possession": 50.0,
      "status": { "label": "en_cours", "legacy_value": 40 },
      "start_date": "2024-01-01",
      "steps": {
        "3": {
          "name_fr": "Avant construction",
          "name_en": "Pre-construction",
          "name_es": "Preconstrucción",
          "status": "current",
          "date": { "begin": "2024-01-01", "end": "" },
          "sub_steps": {
            "0": { "name_fr": "Definir le projet de construction", "name_en": "Define the construction project", "name_es": "Definir el proyecto de construcción", "status": "completed", "date": { "begin": "", "end": "" } },
            "1": { "name_fr": "Estimer le budget global prévisionnel", "name_en": "Estimate the overall provisional budget", "name_es": "Estimar el presupuesto global previsto", "status": "current", "date": { "begin": "", "end": "" } }
          }
        }
      }
    }
  ]
}