CKAN

CKAN est une solution open source de management de données dont la documentation est disponible à cette adresse : http://docs.ckan.org/

 

Spécificités Pôle emploi

Le champ pe_source contient la codification Pôle emploi de la ressource.

Le champ pe_type permet de distinguer les trois types de ressources suivantes :

  • api → fichier principal des données
  • documentation → documentation associée au jeu de données
  • reference → contient une partie de la nomenclature Pôle emploi

 

Versionning

Les ressources d’un jeu de données sont versionnées.
Le champ pe_version contient le numéro de version de la ressource.

Sur un dataset, le champ archivable permet de définir si certaines ressources du jeu de données sont archivables ou non.
Actuellement, c’est le cas pour le jeu de données Statistiques sur le marché du travail uniquement.

Le champ pe_status prend 2 valeurs : current (dernière version) ou archive (ancienne version).

 

Requêtes pratiques

Récupérer la liste des jeux de données

GET https://api.emploi-store.fr/partenaire/infotravail/v1/organization_show?id=digidata

 

Lire un jeu de données

GET https://api.emploi-store.fr/partenaire/infotravail/v1/package_show?id=[Identifiant du jeu de données]

 

Lire les informations d’une ressource

GET https://api.emploi-store.fr/partenaire/infotravail/v1/resource_show?id=[Identifiant d'une ressource]

 

Lire le contenu d’une ressource

GET https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search?resource_id=[Identifiant d'une ressource]

 

La manipulation de ressources volumineuses nécessite de limiter le nombre de lignes renvoyées avec les paramètres LIMIT (100 par défaut) et OFFSET.

GET https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search?resource_id=[Identifiant d'une ressource]&limit=[Nombre d'éléments à restituer]&offset=[Position du premier élément]


La requête suivante permet par exemple de retourner une liste de cinq éléments à partir du dixième élément (de 11 à 15).

GET https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search?resource_id=[Identifiant d'une ressource]&limit=5&offset=10


Cette limitation du nombre de résultat peut également être réalisée en SQL :

GET https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search_sql?sql=SELECT * FROM "[Identifiant d'une ressource]" WHERE "CITY_NAME" = 'NANTES' LIMIT 5 OFFSET 10