25:["$","title",null,{"children":"Présentation de la banque de données macroéconomiques (BDM) de l'Insee | Benjamin Picod | Observable"}] 49:T64a,md`

INSEE BDM › 2 - API web

# Découverte de l'API web de la banque de données macroéconomiques (BDM) de l'Insee La BDM a presque 30 ans. Née en 1984, elle proposait déjà 70 000 séries chronologiques, et 10 ans plus tard près de 200 000. En 2015, l'Insee modernise la diffusion de la BDM avec un service web totalement ouvert et gratuit, assis sur le standard ISO [SDMX](https://sdmx.org/). Désormais, la BDM constitue l'un des 5 services du [catalogue d'API proposées par l'Insee](https://api.insee.fr/catalogue/), en complément de *Sirene*, *Données locales*, *Nomenclatures* et *Métadonnées*. Les APIs de l'Insee se présentent sous une forme harmonisée, celle de services web de type REST, que l'on interroge donc par des URL paramétrées, structurées par des /, assez simples à lire et à écrire. Vous pouvez utiliser l'API BDM à partir d'un simple navigateur, ou [avec R](https://github.com/InseeFr/R-Insee-Data), mais il vous faudra d'abord créer votre propre compte sur insee.fr afin de récupérer un jeton, une clé personnelle d'accès aux API. Si, pour la BDM, le service précédent sans jeton ni compte fonctionne encore, cela ne saurait durer très longtemps, il convient donc désormais de s'habituer à la nouvelle API qui, jeton mis à part, fonctionne comme avant avec la syntaxe SDMX. `4a:T65f,chart = { let idbanks = ["010536463", "010536465"] const url = "https://api.insee.fr/series/BDM/V1/data/SERIES_BDM/" + idbanks.join("%2B") // "%2B" équivaut à "+" let xml_string = await fetch(url, fetch_options).then( response => response.text() ) let xml_doc = (new DOMParser).parseFromString(xml_string, "application/xml") let xml_nodelist = d3.hierarchy(xml_doc).descendants() let dt = xml_nodelist .filter(d => d.data.tagName == "Obs") .map(d => { return {TIME_PERIOD: d.data.getAttribute("TIME_PERIOD"), OBS_VALUE: +d.data.getAttribute("OBS_VALUE"), TITLE: d.parent.data.getAttribute("TITLE_FR")} }) return vl.markLine({interpolate:'cardinal'}) .encode( vl.x().fieldT('TIME_PERIOD').title(null), vl.y().fieldQ('OBS_VALUE').title(null).scale({zero: false}), vl.color().fieldN('TITLE').legend({orient:'top', symbolStrokeWidth: 3, symbolSize: 400, labelFontSize: 11, title: null, labelLimit: 300}), vl.tooltip([vl.tooltip().fieldT('TIME_PERIOD').title('période ').format('%Y'), vl.tooltip().fieldQ('OBS_VALUE').format(',').title('valeur ')]) ) .data(dt) .title({anchor:'middle', text: "Mon 1er graphique connecté à l'API web BDM", subtitle: 'Source : Insee BDM' }) .width("container") .height(250) .render({renderer: 'svg'}) }4b:T5eb,dtf_tb = { const url = "https://api.insee.fr/series/BDM/V1/dataflow/FR1/all" let xml_string = await fetch(url, fetch_options ).then( response => response.text() ) let xml_doc = (new DOMParser).parseFromString(xml_string, "application/xml") // XMLDocument let xml_nodelist = d3.hierarchy(xml_doc).descendants() let urls = xml_nodelist.filter(d => d.data.tagName == "com:AnnotationURL") .map(d => ({ url : d.data.innerHTML, dataset : d.parent.parent.parent.data.getAttribute('id') }) ) let libs = xml_nodelist.filter(d => d.data.tagName == "com:Name" && d.data.getAttribute('xml:lang') == 'fr' ) .map(d => ({ lib : d.data.innerHTML, dataset : d.parent.data.getAttribute('id') }) ) let series = xml_nodelist.filter(d => d.data.tagName == "com:AnnotationText") .map(d => ({ series : +d.data.innerHTML.split(':')[1], dataset : d.parent.parent.parent.data.getAttribute('id') }) ) let structures = xml_nodelist.filter(d => d.data.tagName == "str:Structure") .map(d => ({ structure : d.children[0].data.getAttribute('id'), dataset : d.parent.data.getAttribute('id') }) ) return aq.from(urls).join(aq.from(libs)) .join(aq.from(series)) .join(aq.from(structures)) // jointure auto sur le champ commun id }4c:T4c9,md `L'Insee a tout récemment commencé de marquer dans le service web BDM certaines *séries arrêtées*. L'arrêt d'une série, le fait que sa mise à jour ne soit pas poursuivie est un phénomène fréquent et naturel, diverses causes en sont à l'origine : - la source n'est plus maintenue ou accessible, - la série est un indice dont la base (l'année de référence pour laquelle l'indice vaut 100) a changé. Régulièrement les indices voient leur base révisée, - les concepts sous-jacents à la série ont changé. La page descriptive de chaque série (cliquez un identifiant dans la colonne idbank du tableau suivant) expose le fait qu'une série est arrêtée et, généralement, pourquoi et quelle nouvelle série la remplace. Actuellement, **${idbanks_dt.filter(d => op.split(d.list_mod, '.') [op.indexof(op.split(d.list_var, '.'), 'SERIE_ARRETEE')] === 'TRUE').numRows().toLocaleString('fr')}** séries sont signalées arrêtées, ce chiffre devrait augmenter car le "marquage" dans le service SDMX est en cours. Les séries arrêtées conservent un intérêt historique, il est toutefois pratique de pouvoir les laisser de côté quand on explore la BDM via l'API web. `4d:T7cc,// Chargement d'une codelist et stockage dans codelist_map pour ne pas avoir à la recharger get_codelist = async function(cl) { if (!cl) return false if (codelist_map.has(cl)) return codelist_map.get(cl) if (codelist_map.get(cl) === "fetching") // récup en cours, pas la peine de déclencher un nouveau chargement return codelist_map.set(cl, "fetching") const url = "https://api.insee.fr/series/BDM/V1/codelist/FR1/" + cl // gestion du quota de 30 requêtes max par minute pour une clé // s'il est dépassé, on passe à une autre clé via get_fetch_options() let i = 0, xml_codelist_bdm while (i++ <= 5) { // 5 tentatives max xml_codelist_bdm = await fetch(url, get_fetch_options()) .then( response => { if (response.status == 429) { return {error: 429, msg: response.text() } } //quota dépassé return response.text() }) if (typeof xml_codelist_bdm == 'string') i = 10 } let xml_tree = (new DOMParser).parseFromString(xml_codelist_bdm, "application/xml") let nodes = d3.hierarchy(xml_tree) let a = nodes.descendants().filter(d => d.data.tagName == "str:Code") .map(d => { return {id:d.data.getAttribute("id"), lib: d.children.filter(e => e.data.tagName == "com:Name" && e.data.getAttribute('xml:lang') == 'fr')[0].data.innerHTML, c: d.parent.data.getAttribute("id") }}) let b = nodes.descendants().filter(d => d.data.tagName == "str:Codelist") .map(d => d.children.filter(e => e.data.tagName == "com:Name" && e.data.getAttribute('xml:lang') == 'fr')[0].data.innerHTML) codelist_lib_map.set(cl, b[0]) let dt = aq.from(a) codelist_map.set(cl, aq.from(a)) // stockage dans une hashmap centrale sous forme d'une table Arquero return dt }4e:[{"id":"b5f61a396dab67344a4117f95933f63f6d7891ee6d3f1934830fd39dbaf0861684a2b7d9a6adaa77d126b1a520a4a6580fc1e506208f6fff7b98da3099d6e164","href":"https://static.observableusercontent.com/files/b5f61a396dab67344a4117f95933f63f6d7891ee6d3f1934830fd39dbaf0861684a2b7d9a6adaa77d126b1a520a4a6580fc1e506208f6fff7b98da3099d6e164","name":"api_insee_cle_jeton.png","type":"image/png","lastModified":1682501667440.927,"size":8655},{"id":"fbdd0e67e3e1df21ecee53d6fe4e12e1cd472f8c2089be8a0994f6395c74d46f099bd2d9e0985977a28d7276b9941778f98d7a4e3905b2ca25687e165632e0d0","href":"https://static.observableusercontent.com/files/fbdd0e67e3e1df21ecee53d6fe4e12e1cd472f8c2089be8a0994f6395c74d46f099bd2d9e0985977a28d7276b9941778f98d7a4e3905b2ca25687e165632e0d0","name":"api_insee_cle_jeton2.png","type":"image/png","lastModified":1682501667440.927,"size":7357},{"id":"193fc6e3584c2d1bea48f421d4febb8f87c28777a86ff8976431d48a2259ffa3f57a2101279d918b7ec4985c64fed798116c7f00e0848e43b904d3797fdf5b1e","href":"https://static.observableusercontent.com/files/193fc6e3584c2d1bea48f421d4febb8f87c28777a86ff8976431d48a2259ffa3f57a2101279d918b7ec4985c64fed798116c7f00e0848e43b904d3797fdf5b1e","name":"api_insee_bdm_idbank.png","type":"image/png","lastModified":1682501667440.927,"size":14940}] 29:{"id":"7659745d95b123a7","slug":null,"title":"Présentation de la banque de données macroéconomiques (BDM) de l'Insee","thumbnail":"6a283dc99cc1fa4412c551b2aa612c67a1dcdb0fc4bec8b28ef70a6fab36e018","access_level":"public","create_time":"$D2023-04-26T09:34:27.440Z","update_time":"$D2023-06-19T08:53:41.649Z","view_time":null,"first_public_time":"$D2023-04-26T09:34:27.440Z","has_unpublished_edits":null,"fork":{"id":"ffc3d66e1315cc0a","slug":"decouverte-de-l-api-web-banque-de-donnees-macroeconomiques-bdm","title":"Présentation de la banque de données macroéconomiques (BDM) de l'Insee","owner":{"id":"cd09b02ddc62abda","login":"ericmauviere","name":"Éric Mauvière"}},"stars":0,"starred":false,"owner":{"type":"team","id":"76739ff3d068a96c","login":"bpicod","name":"Benjamin Picod","avatar_url":"https://avatars-next.observableusercontent.com/6b375e8997394156ec3faf704d4b2748e1fed2651347f717e3e5988f3e84164a","tier":"starter_2024","bio":"Webmaster for INSEE (French National Institute of Statistics and Economic Analysis). Interested in web based datavisualisation, libraries and tools.","following":false},"version":686,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"b0047ee932812541","login":"bpicod","name":"Benjamin Picod","avatar_url":"https://avatars-next.observableusercontent.com/6b375e8997394156ec3faf704d4b2748e1fed2651347f717e3e5988f3e84164a","tier":null,"bio":"Webmaster for INSEE (French National Institute of Statistics and Economic Analysis). Interested in web based datavisualisation, libraries and tools.","following":false}],"members":[{"type":"individual","id":"b0047ee932812541","login":"bpicod","name":"Benjamin Picod","avatar_url":"https://avatars-next.observableusercontent.com/6b375e8997394156ec3faf704d4b2748e1fed2651347f717e3e5988f3e84164a","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Présentation de la banque de données macroéconomiques (BDM) de l'Insee","cells":[{"id":0,"value":"$49","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":236,"value":"toc()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":230,"value":"md `## 1 - Premiers pas avec l'API`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":233,"value":"md `### Créer un compte, générer un premier jeton d'accès`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":118,"value":"md `Pour accéder aux API, direction https://api.insee.fr/ !\n\nPour commencer, il convient de créer un compte, se connecter, aller dans \"Mes applications\", choisir \"DefaultApplication\" (mais vous pouvez créer d'autres \"applications\"), puis l'onglet \"Clefs et jetons d'accès\".\n\nLa période de validité par défaut correspond (en secondes) à une semaine, mais vous pouvez en réalité la multiplier par 100, ce qui la portera à près de deux ans, voilà qui est tout de suite plus confortable !\n\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":120,"value":"FileAttachment(\"api_insee_cle_jeton.png\").image()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":123,"value":"md `Avec le bouton \"Montrer les clés\" en tête de formulaire, vous êtes en mesure de copier votre jeton :`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":125,"value":"FileAttachment(\"api_insee_cle_jeton2.png\").image()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":128,"value":"md `Pour le placer par exemple ci-dessous en lieu et place de \\${API_KEY}. Mais, rassurez-vous, vous pourrez le faire plus tard, ce document utilise une clé par défaut. `","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":68,"value":"fetch_options = get_fetch_options() /*({\n headers: {\n Authorization: `Bearer ${API_KEY}`, //37bcb284-333f-37fe-951c-151802198031\n 'Content-Type': 'text/xml; charset=UTF-8'\n }\n })*/","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":447,"value":"md `L'API web surveille le rythme de vos sollicitations, vous ne pourrez ainsi pas dépasser 30 requêtes par minute avec la même clé. Pour un usage personnel, cela ne devrait pas vous gêner. Sur une page comme celle-ci, qui peut accueillir plusieurs visteurs simultanés, cette contrainte peut peser. Je la contourne en travaillant avec un *pool de jetons* que cette page utilise par roulement.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":139,"value":"md `### Première requête : obtention des valeurs d'une série chronologique\nCet objet de configuration \\`fetch_options\\` va nous permettre d'utiliser l'API web et ses trois ou quatre requêtes-types (issues du standard SDMX). \n\nElles sont décrites dans la [console de l'API BDM](https://api.insee.fr/catalogue/site/themes/wso2/subthemes/insee/pages/item-info.jag?name=BDM&version=V1&provider=insee).\nCommençons par la plus simple, celle qui permet de de récupérer une série, identifiée par un code (dénommé IDBANK). Il est possible de relever de tels codes dans l'espace [Séries chronologiques](https://www.insee.fr/fr/information/2860814) d'insee.fr.\n\n[Exemple de page de présentation d'une série, avec son identifiant IDBANK](https://www.insee.fr/fr/statistiques/serie/000067681#Graphique)\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":149,"value":"FileAttachment(\"api_insee_bdm_idbank.png\").image()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":158,"value":"md `Le bloc suivant expose l'URL de requête et la façon de la lancer avec l'instruction JavaScript \\`fetch()\\`, prenant en compte les options d'authentification définies plus haut :`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":156,"value":"{\n let idbank = \"000067681\" // taux de mortalité infantile\n \n const url = \"https://api.insee.fr/series/BDM/V1/data/SERIES_BDM/\" + idbank\n\n return fetch(url, fetch_options).then( response => response.text() )\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":166,"value":"md `Cette requête renvoie un fichier au format XML ! Complétons maintenant les instructions précédentes pour tirer parti de cette chaine XML :`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":25,"value":"xml_nodelist = {\n\n let idbank = \"000067681\" // taux de mortalité infantile\n \n const url = \"https://api.insee.fr/series/BDM/V1/data/SERIES_BDM/\" + idbank\n\n let xml_string = await fetch(url, fetch_options).then( response => response.text() ) \n \n let xml_doc = (new DOMParser).parseFromString(xml_string, \"application/xml\") // XMLDocument\n\n console.log(\"Dépliez cet arbre :\", xml_doc)\n \n return d3.hierarchy(xml_doc).descendants() \n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":364,"value":"md `Si vous ouvrez la console de votre navigateur, vous verrez la structure XML obtenue à partir de la réponse textuelle du service : il s'agit bien d'un arbre dépliable, celui d'un \\`XMLDocument\\`.\n\nL'utilitaire \\`d3.hierarchy()\\` l'optimise en le transformant en graphe hiérarchique, un \\`array JavaScript\\` plus facilement manipulable.\n\nLa requête suivante filtre ce graphe pour ne retenir que les nœuds de type \\`OBS\\` (Observation), soit les données finales, avec leurs deux attributs centraux \\`TIME_PERIOD\\` et \\`OBS_VALUE\\` :`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":37,"value":"serie_data = {\n return xml_nodelist\n .filter(d => d.data.tagName == \"Obs\") \n .map(d => { return {TIME_PERIOD:d.data.getAttribute(\"TIME_PERIOD\"), \n OBS_VALUE: +d.data.getAttribute(\"OBS_VALUE\")}\n })\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":378,"value":"md `Récupérons maintenant quelques attributs additionnels informant sur le statut de chaque valeur. SDMX permet en effet de qualifier chaque donnée selon son *statut* (normal, révisé, provisoire), sa *qualité* (définitive, estimée) ou son *type* (donnée normale, manquante...) :`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":56,"value":"viewof serie_dt = {\n let a = xml_nodelist\n .filter(d => d.data.tagName == \"Obs\") \n .map(d => { return {TIME_PERIOD: d.data.getAttribute(\"TIME_PERIOD\"), \n OBS_VALUE: +d.data.getAttribute(\"OBS_VALUE\"),\n IDBANK: d.parent.data.getAttribute(\"IDBANK\"), // remontée niveau parent\n OBS_STATUS: d.data.getAttribute(\"OBS_STATUS\"),\n OBS_QUAL: d.data.getAttribute(\"OBS_QUAL\"),\n OBS_TYPE: d.data.getAttribute(\"OBS_TYPE\")\n }\n })\n \n return Inputs.table(a, {locale: 'fr'})\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":442,"value":"md `Une donnée estimée en fin de période par exemple pourra ainsi être traduite par un tracé pointillé dans un graphique, ou marquée par un * dans un tableau. `","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":347,"value":"md `## 2 - Visualisation de séries dans un graphique d'évolution`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":252,"value":"md `### Un script pour mettre en courbes deux séries\nAvec quelques lignes de Vega-Lite, cette belle et intuitive librairie graphique, je compose un graphique avec les données et métadonnées tirées du service. Je choisis ici d'appeler simultanément deux séries, passant leur identifiant dans une chaine délimitée par des +. \n\nJe peux théoriquement demander jusqu'à 200 séries dans la même requête, mais si le volume de données à récupérer devient trop important, l'API m'invitera à réduire mes ambitions.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":181,"value":"$4a","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":456,"value":"md `Note : vous pouvez exporter ce graphique au format SVG haute résolution via le menu contextuel gauche.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":63,"value":"md `## 3 - Parcours de quelques requêtes SDMX\n\n*Statistical Data and Metadata eXchange* (SDMX) est une initiative soutenue par sept institutions de classe mondiale (BRI, BCE, Eurostat, FMI, OCDE, ONU et la Banque mondiale) dans le but de fournir un standard d'échange d'informations statistiques. C'est un standard Iso depuis 2013.\n\nAinsi cette requête REST https://ec.europa.eu/eurostat/SDMX/diss-web/rest/dataflow/ESTAT/all founit-elle la liste de tous les datasets proposés par Eurostat au travers de son service web SDMX.\n\nSDMX 2.1 permet théoriquement de spécifier différents formats de sortie, outre XML, par exemple JSON ou CSV\n:\n- https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/NAMA_10_GDP?format=JSON&lang=en\n- https://ec.europa.eu/eurostat/api/dissemination/sdmx/2.1/data/NAMA_10_GDP?format=CSV\n\nLe service web SDMX de l'Insee ne propose pour l'heure que le XML, mais devrait prochainement diversifier ses formats de sortie. \n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":397,"value":"md `### Liste des datasets de la BDM Insee`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":465,"value":"md `Le bloc suivant fait appel à une requête SDMX de type \\`dataflow\\`, elle produit la liste de tous les datasets de la BDM. J'associe données et métadonnées ainsi récupérées dans une table [Arquero](https://www.icem7.fr/outils/arquero-manipuler-des-tables-en-javascript-aussi-facilement-quavec-r/), triée par nombre de séries décroissant :`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":66,"value":"$4b","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":471,"value":"md `Le dataset \\`SERIES_BDM\\` a un caractère quelque peu fictif, il recouvre en réalité l'ensemble des séries, et sert à interroger l'API web avec un identifiant IDBANK, sans qu'il soit besoin de préciser le dataset visé :`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":97,"value":"Inputs.table(dtf_tb, {locale:'fr', sort:'series', reverse: true, \n format:{url : d => html`${d}`}})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":477,"value":"md `Le concept d'idbank est inhérent à la BDM, depuis sa création, ce n'est pas un concept SDMX. Pour autant, il facilite bien les choses, permettant d'accéder à une série par un simple code, plutôt que par une combinaison de modalités de dimensions. \n\nAinsi, la requête par idbank \\`010536463\\` sur la série \"Espérance de vie des femmes\" :\n\nhttps://api.insee.fr/series/BDM/V1/data/SERIES_BDM/010536463\n\nest en réalité équivalente à cette requête sur le dataset \\`DECES-MORTALITE\\` :\n\nhttps://api.insee.fr/series/BDM/V1/data/DECES-MORTALITE/A.ESPERANCE_VIE.VALEUR_ABSOLUE.ESPV.FE.2.SO.ANNEES.BRUT\n\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":487,"value":"md `L'Insee fournit [un fichier CSV](https://www.insee.fr/fr/statistiques/fichier/2862759/2021_correspondance_idbank_dimension.zip) qui décrit la correspondance entre chaque idbank et les modalités de dimensions correspondantes.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":262,"value":"idbanks_dt = aq.loadCSV(insee_csv_url, {parse:{idbank: String}}) ","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":273,"value":"Inputs.table(idbanks_dt, {layout:'auto',\n format:{idbank : d => html`${d}`}\n })","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":496,"value":"md `Le champ \\`famille\\` identifie chaque dataset, \\`list_var\\` énumère les dimensions du dataset et \\`list_mod\\` les modalités spécifiques dont le croisement définit chaque série. Ce fichier s'avère très utile car il liste toutes les séries et seulement celles (et donc les croisements associés) disponibles.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":501,"value":"md `### Les séries arrêtées`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":518,"value":"$4c","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":504,"value":"Inputs.table( idbanks_dt.filter(d => op.split(d.list_mod, '.')\n [op.indexof(op.split(d.list_var, '.'), 'SERIE_ARRETEE')] === 'TRUE'),\n {layout:'auto', format:{idbank : d => html`${d}`}\n })","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":533,"value":"md `Voici en l'état le taux de *séries arrêtées* pour quelques datasets de la BDM :`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":298,"value":"Inputs.table(idbanks_dt.derive({sa: d => op.split(d.list_mod, '.')\n [op.indexof(op.split(d.list_var, '.'), 'SERIE_ARRETEE')] === 'TRUE' ? 1 : 0})\n\n .groupby('famille').rollup({tx_serie_arretee: d => 0.1*op.round(1000*op.sum(d.sa)/op.count())})\n .filter('d.tx_serie_arretee>0')\n .orderby(aq.desc('tx_serie_arretee'))\n .rename({'famille':'dataset'})\n ,{locale:'fr', layout:'auto', width:400}\n )","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":566,"value":"md `### Nomenclatures (codelists)`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":564,"value":"md `Chaque dimension d'un dataset déroule des modalités, relevant d'une nomenclature, comme celle des FREQ (périodicité) : `","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":562,"value":"Inputs.table(await get_codelist(\"CL_PERIODICITE\"),\n {columns:['id','lib'], layout:'auto', maxWidth:'200px'})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":580,"value":"md `Ou celle des INSTRUMENTS_BALANCE_PAIEMENTS : `","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":569,"value":"Inputs.table(await get_codelist(\"CL_INSTRUMENTS_BALANCE_PAIEMENTS\"), {columns:['id','lib'],layout:'auto'})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":653,"value":"md `Cette fonction permet d'obtenir une *codelist* quelconque selon la syntaxe SDMX :`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":572,"value":"$4d","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":573,"value":"codelist_map = new Map()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":575,"value":"codelist_lib_map = new Map()","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":630,"value":"md `## 4 - Pour en savoir plus\n\n[Guide détaillé d'utilisation de la BDM](https://www.insee.fr/fr/statistiques/fichier/2862759/BDM_serviceweb_SDMX_V2_2_guideutilisation.pdf)\n\n[Package R - Insee](https://github.com/InseeFr/R-Insee-Data)\n\n[Le site officiel SDMX](https://sdmx.org/)\n\n[Catalogue des API de l'Insee](https://api.insee.fr/catalogue/)\n\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":555,"value":"md `---\n### Utilitaires de connexion et librairies`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":9,"value":"get_fetch_options = function() {\n return {\n headers: {\n Authorization: `Bearer ${API_KEY}`,\n 'Content-Type': 'text/xml; charset=UTF-8'\n }\n }\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":114,"value":"API_KEY = 'ea1f16b6-5a92-31e6-8b22-66f0028f5641'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":7,"value":"endpoint = `@ericmauviere/stockage-cdn-proxy-du-fichier-de-reference-insee-bdm-idbanks`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":11,"value":"insee_csv_name = \"insee_bdm_idbanks_2023_06.csv\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":6,"value":"//insee_csv_url = \"https://webcode.run/notebooks/@ericmauviere/stockage-cdn-proxy-du-fichier-de-reference-insee-bdm-idbanks/deploys/${insee_csv_name}\"\n\ninsee_csv_url = \"https://webcode.run/observablehq.com/d/4b835881845f9b36;insee_bdm_idbanks_2023_06.csv\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":49,"value":"import { aq, op } from '@uwdata/arquero'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":238,"value":"import {tuto_styles, toc} from '@ericmauviere/techniques-pour-tutoriels'","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":239,"value":"tuto_styles","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W4e","stdlib":"1"}} 24:null