API - Observatoire de données

Paramètre obligatoire en header :

• apiKey : clé API à demander en s'inscrivant ici.

Format de la réponse :

{
  "themes": [
    {
      "name": "social-networks",
      "label": "Réseaux Sociaux"
    },
    {
      "name": "privacy",
      "label": "Protection des données"
    }
  ]
}
                            

• name : nom du thème
• label : libellé du theme

Paramètre obligatoire en header :

• apiKey : clé API à demander en s'inscrivant ici.

Paramètre obligatoire de l'url :

• theme_name : nom du thème

Format de la réponse :

{
  "indicators": [
    {
      "name": "facebooktime",
      "label": "Combien d’amis Facebook connaisez-vous réellement ?",
      "theme_name": "social-networks",
      "theme_label": "Réseaux Sociaux"
    }
  ]
}
                            

• name : nom de l'indicateur
• label : libellé de l'indicateur
• theme_name : nom du theme
• theme_label : libellé du theme

Paramètre obligatoire en header :

• apiKey : clé API à demander en s'inscrivant ici.

Paramètre obligatoire de l'url :

• indicator_name : nom de l'indicateur

Paramètres optionnels de l'url:

• compare_by : gender | sec | month | age_range | network | area
• method : mean
• gender : male, female
• sec : study | work | outofwork | retired
• age_range : 0-18 | 19-30 | 31-45 | 46-60 | 61-75
• area : idf | ara | npcp | lrmp | est | paca | pdl | nor | bre | bfc | cvl | reu | gua | mar | cor | guy | may
• month_min : yyyy-mm
• month_max : yyyy-mm
• facebook_logged : true, false
• twitter_logged : true, false

Certains filtres peuvent recevoir plusieurs valeurs séparées par | .

Format de la réponse :

/api-data-consumer/v1/statistics/socialnetworks?compare_by=age_range&age_range=0-18|19-30

{
  "parameter": {
    "age_range": [
      "0-18",
      "19-30",
      "31-45",
      "46-60",
      "61-75"
    ]
  },
  "filters": {
    "age_range": [
      "0-18",
      "19-30"
    ]
  },
  "method": "sum",
  "indicator": {
    "name": "socialnetworks",
    "label": "Quels sont vos usages des réseaux sociaux ?",
    "total": 92,
    "slots": [
      {
        "name": "question1-a3",
        "label": "suivre l’actualité",
        "value": 0,
        "number": 14
      },
      {
        "name": "question1-a4",
        "label": "pour le travail",
        "value": 0,
        "number": 17
      },
      {
        "name": "question1-a1",
        "label": "partager du contenu",
        "value": 0,
        "number": 46
      },
      {
        "name": "question1-a2",
        "label": "discuter avec des amis",
        "value": 0,
        "number": 15
      }
    ]
  },
  "stats": [
    {
      "set": {
        "age_range": "0-18"
      },
      "total": 24,
      "slots": [
        {
          "name": "question1-a3",
          "label": "suivre l’actualité",
          "value": 0,
          "number": 3,
          "percentage": 12.5
        },
        {
          "name": "question1-a4",
          "label": "pour le travail",
          "value": 0,
          "number": 5,
          "percentage": 20.83
        },
        {
          "name": "question1-a1",
          "label": "partager du contenu",
          "value": 0,
          "number": 12,
          "percentage": 50
        },
        {
          "name": "question1-a2",
          "label": "discuter avec des amis",
          "value": 0,
          "number": 4,
          "percentage": 16.67
        }
      ]
    },
    {
      "set": {
        "age_range": "19-30"
      },
      "total": 68,
      "slots": [
        {
          "name": "question1-a3",
          "label": "suivre l’actualité",
          "value": 0,
          "number": 11,
          "percentage": 16.18
        },
        {
          "name": "question1-a4",
          "label": "pour le travail",
          "value": 0,
          "number": 12,
          "percentage": 17.65
        },
        {
          "name": "question1-a1",
          "label": "partager du contenu",
          "value": 0,
          "number": 34,
          "percentage": 50
        },
        {
          "name": "question1-a2",
          "label": "discuter avec des amis",
          "value": 0,
          "number": 11,
          "percentage": 16.18
        }
      ]
    },
    {
      "set": {
        "age_range": "31-45"
      },
      "total": 0,
      "slots": [
        {
          "name": "question1-a3",
          "label": "suivre l’actualité",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        },
        {
          "name": "question1-a4",
          "label": "pour le travail",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        },
        {
          "name": "question1-a1",
          "label": "partager du contenu",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        },
        {
          "name": "question1-a2",
          "label": "discuter avec des amis",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        }
      ]
    },
    {
      "set": {
        "age_range": "46-60"
      },
      "total": 0,
      "slots": [
        {
          "name": "question1-a3",
          "label": "suivre l’actualité",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        },
        {
          "name": "question1-a4",
          "label": "pour le travail",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        },
        {
          "name": "question1-a1",
          "label": "partager du contenu",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        },
        {
          "name": "question1-a2",
          "label": "discuter avec des amis",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        }
      ]
    },
    {
      "set": {
        "age_range": "61-75"
      },
      "total": 0,
      "slots": [
        {
          "name": "question1-a3",
          "label": "suivre l’actualité",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        },
        {
          "name": "question1-a4",
          "label": "pour le travail",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        },
        {
          "name": "question1-a1",
          "label": "partager du contenu",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        },
        {
          "name": "question1-a2",
          "label": "discuter avec des amis",
          "value": 0,
          "number": 0,
          "total": 0,
          "percentage": 0
        }
      ]
    }
  ]
}
                        

• parameter : les paramètres de comparaison statistique (compare_by) de la requête
• filters : les filtres statistiques de la requête
• method : méthode utilisée pour le calcul (sum ou mean)

• indicator : informations globales sur l indicateur sélectionné
• slots : réponses de l'indicateur

• stats : statistiques demandées par la requête
• set : échantillon concerné
• label : libellé du slot
• value : valeur mathématique du slot (ex: 1,5 pour 1h30)
• number : nombre de résultats du slot
• total : somme totale des résultats du set
• percentage : pourcentage du nombre de résultats du slot sur la somme totale des résultats du set