Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Methode pour récupérer les collections de concepts #148

Open
EmmanuelDemey opened this issue Nov 8, 2024 · 3 comments
Open

Methode pour récupérer les collections de concepts #148

EmmanuelDemey opened this issue Nov 8, 2024 · 3 comments
Assignees

Comments

@EmmanuelDemey
Copy link
Collaborator

No description provided.

@EmmanuelDemey
Copy link
Collaborator Author

@flo7894 doit spécifier ce ticket

@flo7894
Copy link

flo7894 commented Nov 22, 2024

Concepts

Collection de concepts

Requête

Méthode Requête Description
GET /concepts/collection/{id} Informations sur une collection de concepts statistiques

Paramètres

Paramètres Description Type
id identifiant interne de la collection string

Exemples de requête

/concepts/collection/definitions-insee-fr

Champs de la réponse

Champ Description
uri identifiant unique de la collection de concepts statistiques
id identifiant interne de la collection de concepts statistiques dans le référentiel de métadonnées statistiques
intitule libellé de la collection de concepts statistiques
description description de la collection de concepts statistiques
contenu chaîne de caractère ou html associé aux champs : intitulé, description
langue langue du champ contenu
dateMiseAJour dernière date de modification de la collection de concepts statistiques

Exemple de réponse en XML

<Collection id="definitions-insee-fr" uri="http://id.insee.fr/concepts/collection/definitions-insee-fr">
   <DateMiseAJour>2024-11-01</DateMiseAJour>
   <Intitule langue="fr">
      <contenu>Concepts affichés sur insee.fr</contenu>
   </Intitule>
   <Intitule langue="en">
      <contenu>Concepts displayed on insee.fr</contenu>
   </Intitule>
   <Description langue="fr">
      <contenu>Ensemble des concepts affichés sur la page définitions du site insee.fr</contenu>
   </Description>
   <Description langue="en">
      <contenu>All concepts displayed on the "définitions" section from the website insee.fr</contenu>
   </Description>
</Collection>

Exemple de réponse en JSON

{
   "id": "definitions-insee-fr",
   "uri": "http://id.insee.fr/concepts/collection/definitions-insee-fr",
   "dateMiseAJour": "2024-11-01",
   "intitule": [
      {
         "contenu": "Concepts affichés sur insee.fr",
         "langue": "fr", 
      },
      {
         "contenu": "Concepts displayed on insee.fr",
         "langue": "en", 
      }
   ],
   "description": [
      {
         "contenu": "Ensemble des concepts affichés sur la page définitions du site insee.fr",
         "langue": "fr", 
      },
      {
         "contenu": "All concepts displayed on the \"définitions\" section from the website insee.fr",
         "langue": "en", 
      }
   ]
}

Exemple de requête SPARQL

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
PREFIX dct: <http://purl.org/dc/terms/>
SELECT * 
FROM <http://rdf.insee.fr/graphes/concepts/definitions>
WHERE {
	?uri rdf:type skos:Collection .
	?uri dct:identifier "definitions-insee-fr" .
    ?uri dct:modified ?date_mis_a_jour .
    ?uri dct:title ?intitule_fr .
    FILTER(LANG(?intitule_fr) = 'fr')
    OPTIONAL{
        ?uri dct:title ?intitule_en .
        FILTER(LANG(?intitule_en) = 'en')
    }
    OPTIONAL{
        ?uri dct:description ?description_fr .
        FILTER(LANG(?description_fr) = 'fr')
    }
    OPTIONAL{
        ?uri dct:description ?description_en .
        FILTER(LANG(?description_en) = 'en')
    }
} 

Ensemble des concepts d'une collection

Requête

Méthode Requête Description
GET /concepts/collection/{id}/concepts Ensemble des concepts statistiques d'une collection

Paramètres

Paramètres Description Type
id identifiant interne de la collection string

Exemples de requête

/concepts/collection/definitions-insee-fr/concepts

Champs de la réponse

Champ Description
concept concept statistique faisant partie de la collection
uri identifiant unique du concept statistique
id identifiant interne du concept statistique dans le référentiel de métadonnées statistiques

Exemple de réponse en XML

<Concepts>
   <Concept id="c1632" uri="http://id.insee.fr/concepts/definition/concepts/c1632">
   <Concept id="c1365" uri="http://id.insee.fr/concepts/definition/concepts/c1365">
</Concepts>

Exemple de réponse en JSON

[
   {
      "id": "c1632",
      "uri": "http://id.insee.fr/concepts/definition/concepts/c1632"
   },
   {
      "id": "c1365",
      "uri": "http://id.insee.fr/concepts/definition/concepts/c1365"
   }
]

Exemple de requête SPARQL

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
PREFIX dct: <http://purl.org/dc/terms/>
SELECT ?uri_concept ?id_concept
FROM <http://rdf.insee.fr/graphes/concepts/definitions>
WHERE {
   ?uri rdf:type skos:Collection .
   ?uri dct:identifier "definitions-insee-fr" .
   OPTIONAL{
      ?uri skos:member ?uri_concept .
      ?uri_concept skos:notation ?id_concept 
    }
} ORDER BY ?uri_concept

@flo7894
Copy link

flo7894 commented Nov 22, 2024

@GtanSndil GtanSndil self-assigned this Dec 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants