SlideShare une entreprise Scribd logo
API DE HAL
1. Les API de recherche HAL
2. Référentiels
3. Documents
Raphaël Tournoy
Les API de HAL
TYPES D’API DISPONIBLES https://api.archives-ouvertes.fr/
API de recherche
•
•
•
•
•
•
•
•
•
•
•
•
API - RECHERCHE : CONTENUS DISPONIBLES
PRÉ-REQUIS TECHNIQUES
API des référentiels
LES RÉFÉRENTIELS https://api.archives-ouvertes.fr/docs/ref
QUELS TYPES DE RÉFÉRENTIELS ?
…
RECHERCHE
Référentiels
Exemples d’utilisation
INSTANCE : LES PORTAILS
Comment obtenir la liste des portails de HAL où déposer ?
https://api.archives-ouvertes.fr/r
ef/doctype/?wt=json
Format JSON /?wt=json
DOCTYPE : TYPES DE DOCUMENTS
Exemple : Types de document acceptés sur TEL ( instance_s=tel )
Format JSON
METADATA : MÉTADONNÉES PAR TYPE DE DOCUMENT
instance_s=univ-lorraine
portail : Université de
Lorraine)
docType_s=ART
METADATALIST : MÉTADONNÉES DE TYPE LISTE FERMÉE
Métadonnée audience = 3 valeurs possibles
METADATALIST :
LISTE DES MÉTADONNÉES DE TYPE LISTE FERMÉE
Quelles sont les valeurs acceptées pour la métadonnée AUDIENCE ?
https://api.archives-ouvertes.fr/ref/metadatalist/?q=metaName_s:audience
Référentiels
Types complexes
TYPES COMPLEXES
AUTEURS ; STRUCTURES ; DOMAINES ; REVUES ; PROJETS ANR ; PROJETS EUROPÉENS
Consultation publique HTML : https://aurehal.archives-ouvertes.fr/
EXEMPLE STRUCTURE DANS AURÉHAL
API STRUCTURE : EXEMPLE AU FORMAT JSON
CHAQUE RÉFÉRENTIEL A SES PROPRES CHAMPS
https://api.archives-ouvertes.fr/docs/ref/resource/journal/schema/fields/#fields
Exemple : Référentiel des revues
EXEMPLE RECHERCHE : RÉFÉRENTIEL REVUES
https://api.archives-ouvertes.fr/ref/journal/?wt=json&q=publisher_t:(Elsevier)&fq=valid_s:VALID&fq=sherpaColor_s:green&
fl=title_s,publisher_s,sherpaColor_s,valid_s&sort=title_s asc
wt=json format de retour JSON
q=publisher_t:(Elsevier)
revues dont l’éditeur est elsevier
&fq=valid_s:VALID limiter
aux revues validées
fq=sherpaColor_s:green
uniquement les couleurs “green”
dans SHERPA
&fl=title_s,publisher_s,sherpaC
olor_s,valid_s champs à afficher
dans la réponse
&sort=title_s asc trier les résultats
par titre
Revues avec le statut ‘green’ dans Sherpa où l’éditeur est Elsevier et la revue est validée dans le référentiel
API Documents de HAL
CONTENU API DOCUMENTS HAL
CONTENU API DOCUMENTS HAL
Les API de HAL
API RECHERCHE – TYPES DE CHAMPS
API RECHERCHE – EXEMPLES DE CHAMPS
API RECHERCHE - REQUÊTES
API RECHERCHE - REQUÊTES
API RECHERCHE - REQUÊTES
PRINCIPAUX PARAMÈTRES
API - construire une requête
API REQUÊTES / PARAMÈTRE WT = FORMAT
DE RÉPONSE (WT=FORMAT)
https://api.archives-ouvertes.fr/search/?wt=xml
API REQUÊTES / PARAMÈTRE Q = CRITÈRE DE
RECHERCHE (Q=TERME)
https://api.archives-ouvertes.fr/search/?q=api
API REQUÊTES / PARAMÈTRE Q POUR
CHERCHER DANS UN CHAMP (CHAMP:VALEUR)
https://api.archives-ouvertes.fr/search/?q=title_t:api
API REQUÊTES / PARAMÈTRE FQ FILTRER
AVEC UN CHAMP (CHAMP:VALEUR)
https://api.archives-ouvertes.fr/search/?q=title_t:api&fq=submitType_s:file&wt=xml
API REQUÊTES / PARAMÈTRE FL LISTE DE
CHAMPS À RETOURNER (FL=CHAMP1,CHAMP2)
https://api.archives-ouvertes.fr/search/?wt=xml&fl=*tdate,title_s
API REQUÊTES / PARAMÈTRE SORT POUR TRIER
(SORT=CHAMP1,CHAMP2) (ASC|DESC)
/search/?wt=xml&fl=submittedDate_tdate,title_s&sort=submittedDate_tdate desc
Construire une requête -
Facettes
API REQUÊTES / FACETTES : FACET=TRUE &
FACET.FIELD=CHAMP
/search/?q=*:*&rows=0&wt=xml&facet=true&facet.field=docType_s
API REQUÊTES / FACETTES PIVOT :
FACET=TRUE & FACET.PIVOT=CHAMP1,CHAMP2
/search/?q=*:*&rows=0&wt=xml&indent=true&facet=true&facet.pivot=docType_s,submitType_s
API REQUÊTES / FACETTES PLAGE :
FACET=TRUE & FACET.RANGE=CHAMP
search/?q=*:*&rows=0&wt=xml&indent=true&facet=true&facet.range=submittedDateY_i&facet.range.start=19
90&facet.range.end=2010&facet.range.gap=2
Les API de HAL

Contenu connexe

Similaire à Les API de HAL

Usage des API de HAL
Usage des API de HALUsage des API de HAL
Usage des API de HAL
OAccsd
 
Archives ouvertes et thèses en ligne : HAL et TEL
Archives ouvertes et thèses en ligne : HAL et TELArchives ouvertes et thèses en ligne : HAL et TEL
Archives ouvertes et thèses en ligne : HAL et TEL
BUPMCformM
 
Les évolutions de HAL : présentation du 20 septembre 2017
Les évolutions de HAL : présentation du 20 septembre 2017Les évolutions de HAL : présentation du 20 septembre 2017
Les évolutions de HAL : présentation du 20 septembre 2017
OAccsd
 
SPARQL-Generate, présentation SemWeb.Pro 2019
SPARQL-Generate, présentation SemWeb.Pro 2019SPARQL-Generate, présentation SemWeb.Pro 2019
SPARQL-Generate, présentation SemWeb.Pro 2019
Maxime Lefrançois
 
HAL référentiels : Journée affiliations Paris juin 2015
HAL référentiels : Journée affiliations Paris juin 2015HAL référentiels : Journée affiliations Paris juin 2015
HAL référentiels : Journée affiliations Paris juin 2015
OAccsd
 
Jabes 2017 - Poster "Un portail construit avec des API"
Jabes 2017 - Poster "Un portail construit avec des API"Jabes 2017 - Poster "Un portail construit avec des API"
Jabes 2017 - Poster "Un portail construit avec des API"
ABES
 
IdHAL : identité du publiant Bordeaux juin2015
IdHAL :  identité du publiant Bordeaux juin2015IdHAL :  identité du publiant Bordeaux juin2015
IdHAL : identité du publiant Bordeaux juin2015
OAccsd
 
Support de formation à HAL (théorie et pratique)
Support de formation à HAL (théorie et pratique)Support de formation à HAL (théorie et pratique)
Support de formation à HAL (théorie et pratique)
Frédérique Bordignon
 
HAL fonctionnalités avancées juin2015
HAL fonctionnalités avancées juin2015HAL fonctionnalités avancées juin2015
HAL fonctionnalités avancées juin2015
OAccsd
 
Symfony2 & l'architecture Rest
Symfony2 & l'architecture Rest Symfony2 & l'architecture Rest
Symfony2 & l'architecture Rest
Ahmed Ghali
 
REST : Modèle de maturité de Richardson, Pour évaluer la RESTitude de votre API
REST : Modèle de maturité de Richardson, Pour évaluer la RESTitude de votre APIREST : Modèle de maturité de Richardson, Pour évaluer la RESTitude de votre API
REST : Modèle de maturité de Richardson, Pour évaluer la RESTitude de votre API
Ouadie LAHDIOUI
 
Oxalide Workshop #3 - Elasticearch, an overview
Oxalide Workshop #3 - Elasticearch, an overviewOxalide Workshop #3 - Elasticearch, an overview
Oxalide Workshop #3 - Elasticearch, an overview
Ludovic Piot
 
Oxalide Academy : Workshop #3 Elastic Search
Oxalide Academy : Workshop #3 Elastic SearchOxalide Academy : Workshop #3 Elastic Search
Oxalide Academy : Workshop #3 Elastic Search
Oxalide
 
ÉVolution d'un système de publication de données techniques automobiles, modé...
ÉVolution d'un système de publication de données techniques automobiles, modé...ÉVolution d'un système de publication de données techniques automobiles, modé...
ÉVolution d'un système de publication de données techniques automobiles, modé...
SemWebPro
 
Masterclasse i-expo 2011 : Pour un véritable accès unifié à l'information
Masterclasse i-expo 2011 : Pour un véritable accès unifié à l'informationMasterclasse i-expo 2011 : Pour un véritable accès unifié à l'information
Masterclasse i-expo 2011 : Pour un véritable accès unifié à l'information
Antidot
 
API : l'architecture REST
API : l'architecture RESTAPI : l'architecture REST
API : l'architecture REST
Fadel Chafai
 
chapitre 4-PHP5 module web part2 (1).pdf
chapitre 4-PHP5 module web part2 (1).pdfchapitre 4-PHP5 module web part2 (1).pdf
chapitre 4-PHP5 module web part2 (1).pdf
imaneeaouattahee
 
Diaporama du sfPot Lillois du 20 mars 2014
Diaporama du sfPot Lillois du 20 mars 2014Diaporama du sfPot Lillois du 20 mars 2014
Diaporama du sfPot Lillois du 20 mars 2014
Les-Tilleuls.coop
 
Isidore à l'interface de la rencontre des SHS et du Web de données
Isidore à l'interface de la rencontre des SHS et du Web de donnéesIsidore à l'interface de la rencontre des SHS et du Web de données
Isidore à l'interface de la rencontre des SHS et du Web de données
Antidot
 

Similaire à Les API de HAL (19)

Usage des API de HAL
Usage des API de HALUsage des API de HAL
Usage des API de HAL
 
Archives ouvertes et thèses en ligne : HAL et TEL
Archives ouvertes et thèses en ligne : HAL et TELArchives ouvertes et thèses en ligne : HAL et TEL
Archives ouvertes et thèses en ligne : HAL et TEL
 
Les évolutions de HAL : présentation du 20 septembre 2017
Les évolutions de HAL : présentation du 20 septembre 2017Les évolutions de HAL : présentation du 20 septembre 2017
Les évolutions de HAL : présentation du 20 septembre 2017
 
SPARQL-Generate, présentation SemWeb.Pro 2019
SPARQL-Generate, présentation SemWeb.Pro 2019SPARQL-Generate, présentation SemWeb.Pro 2019
SPARQL-Generate, présentation SemWeb.Pro 2019
 
HAL référentiels : Journée affiliations Paris juin 2015
HAL référentiels : Journée affiliations Paris juin 2015HAL référentiels : Journée affiliations Paris juin 2015
HAL référentiels : Journée affiliations Paris juin 2015
 
Jabes 2017 - Poster "Un portail construit avec des API"
Jabes 2017 - Poster "Un portail construit avec des API"Jabes 2017 - Poster "Un portail construit avec des API"
Jabes 2017 - Poster "Un portail construit avec des API"
 
IdHAL : identité du publiant Bordeaux juin2015
IdHAL :  identité du publiant Bordeaux juin2015IdHAL :  identité du publiant Bordeaux juin2015
IdHAL : identité du publiant Bordeaux juin2015
 
Support de formation à HAL (théorie et pratique)
Support de formation à HAL (théorie et pratique)Support de formation à HAL (théorie et pratique)
Support de formation à HAL (théorie et pratique)
 
HAL fonctionnalités avancées juin2015
HAL fonctionnalités avancées juin2015HAL fonctionnalités avancées juin2015
HAL fonctionnalités avancées juin2015
 
Symfony2 & l'architecture Rest
Symfony2 & l'architecture Rest Symfony2 & l'architecture Rest
Symfony2 & l'architecture Rest
 
REST : Modèle de maturité de Richardson, Pour évaluer la RESTitude de votre API
REST : Modèle de maturité de Richardson, Pour évaluer la RESTitude de votre APIREST : Modèle de maturité de Richardson, Pour évaluer la RESTitude de votre API
REST : Modèle de maturité de Richardson, Pour évaluer la RESTitude de votre API
 
Oxalide Workshop #3 - Elasticearch, an overview
Oxalide Workshop #3 - Elasticearch, an overviewOxalide Workshop #3 - Elasticearch, an overview
Oxalide Workshop #3 - Elasticearch, an overview
 
Oxalide Academy : Workshop #3 Elastic Search
Oxalide Academy : Workshop #3 Elastic SearchOxalide Academy : Workshop #3 Elastic Search
Oxalide Academy : Workshop #3 Elastic Search
 
ÉVolution d'un système de publication de données techniques automobiles, modé...
ÉVolution d'un système de publication de données techniques automobiles, modé...ÉVolution d'un système de publication de données techniques automobiles, modé...
ÉVolution d'un système de publication de données techniques automobiles, modé...
 
Masterclasse i-expo 2011 : Pour un véritable accès unifié à l'information
Masterclasse i-expo 2011 : Pour un véritable accès unifié à l'informationMasterclasse i-expo 2011 : Pour un véritable accès unifié à l'information
Masterclasse i-expo 2011 : Pour un véritable accès unifié à l'information
 
API : l'architecture REST
API : l'architecture RESTAPI : l'architecture REST
API : l'architecture REST
 
chapitre 4-PHP5 module web part2 (1).pdf
chapitre 4-PHP5 module web part2 (1).pdfchapitre 4-PHP5 module web part2 (1).pdf
chapitre 4-PHP5 module web part2 (1).pdf
 
Diaporama du sfPot Lillois du 20 mars 2014
Diaporama du sfPot Lillois du 20 mars 2014Diaporama du sfPot Lillois du 20 mars 2014
Diaporama du sfPot Lillois du 20 mars 2014
 
Isidore à l'interface de la rencontre des SHS et du Web de données
Isidore à l'interface de la rencontre des SHS et du Web de donnéesIsidore à l'interface de la rencontre des SHS et du Web de données
Isidore à l'interface de la rencontre des SHS et du Web de données
 

Plus de OAccsd

Reussir mon depot HAL
Reussir mon depot HALReussir mon depot HAL
Reussir mon depot HAL
OAccsd
 
Reussir mon depot HAL
Reussir mon depot HALReussir mon depot HAL
Reussir mon depot HAL
OAccsd
 
Recommandations pour la nouvelle IHM de HAL
Recommandations pour la nouvelle IHM de HAL Recommandations pour la nouvelle IHM de HAL
Recommandations pour la nouvelle IHM de HAL
OAccsd
 
HAL - Evolution du referentiel auteurs 2021
HAL - Evolution du referentiel auteurs 2021HAL - Evolution du referentiel auteurs 2021
HAL - Evolution du referentiel auteurs 2021
OAccsd
 
Deposer dans HAL
Deposer dans HALDeposer dans HAL
Deposer dans HAL
OAccsd
 
SciencesConf : plateforme de gestion de congres scientifiques
SciencesConf : plateforme de gestion de congres scientifiquesSciencesConf : plateforme de gestion de congres scientifiques
SciencesConf : plateforme de gestion de congres scientifiques
OAccsd
 
HAL : optimisation du referencement et de la diffusion des contenus
HAL : optimisation du referencement et de la diffusion des contenusHAL : optimisation du referencement et de la diffusion des contenus
HAL : optimisation du referencement et de la diffusion des contenus
OAccsd
 
La moderation dans HAL
La moderation dans HALLa moderation dans HAL
La moderation dans HAL
OAccsd
 
AUReHAL : referentiel des structures de recherche. Administration des donnees
AUReHAL : referentiel des structures de recherche. Administration des donneesAUReHAL : referentiel des structures de recherche. Administration des donnees
AUReHAL : referentiel des structures de recherche. Administration des donnees
OAccsd
 
Plugin HAL pour Wordpress
Plugin HAL pour WordpressPlugin HAL pour Wordpress
Plugin HAL pour Wordpress
OAccsd
 
TEI HAL - import SWORD
TEI HAL - import SWORDTEI HAL - import SWORD
TEI HAL - import SWORD
OAccsd
 
Utiliser HAL pour valoriser ses travaux et renforcer son identité numérique
Utiliser HAL pour valoriser ses travaux et renforcer son identité numériqueUtiliser HAL pour valoriser ses travaux et renforcer son identité numérique
Utiliser HAL pour valoriser ses travaux et renforcer son identité numérique
OAccsd
 
Episciences, an epijournal management platform
Episciences, an epijournal management platformEpisciences, an epijournal management platform
Episciences, an epijournal management platform
OAccsd
 
Comment diffuser mes données de recherche ?
Comment diffuser mes données de recherche ?Comment diffuser mes données de recherche ?
Comment diffuser mes données de recherche ?
OAccsd
 
Les epirevues avec Episciences
Les epirevues avec EpisciencesLes epirevues avec Episciences
Les epirevues avec Episciences
OAccsd
 
Panorama des identifiants auteurs
Panorama des identifiants auteursPanorama des identifiants auteurs
Panorama des identifiants auteurs
OAccsd
 
IdHAL et CV
IdHAL et CVIdHAL et CV
IdHAL et CV
OAccsd
 
Mes statistiques dans HAL
Mes statistiques dans HALMes statistiques dans HAL
Mes statistiques dans HAL
OAccsd
 
Bib2Hal, import par lot dans HAL à partir d'un fichier BibTeX -formation CCSD...
Bib2Hal, import par lot dans HAL à partir d'un fichier BibTeX -formation CCSD...Bib2Hal, import par lot dans HAL à partir d'un fichier BibTeX -formation CCSD...
Bib2Hal, import par lot dans HAL à partir d'un fichier BibTeX -formation CCSD...
OAccsd
 
Rechercher dans HAL et exploiter les résultats
Rechercher dans HAL et exploiter les résultatsRechercher dans HAL et exploiter les résultats
Rechercher dans HAL et exploiter les résultats
OAccsd
 

Plus de OAccsd (20)

Reussir mon depot HAL
Reussir mon depot HALReussir mon depot HAL
Reussir mon depot HAL
 
Reussir mon depot HAL
Reussir mon depot HALReussir mon depot HAL
Reussir mon depot HAL
 
Recommandations pour la nouvelle IHM de HAL
Recommandations pour la nouvelle IHM de HAL Recommandations pour la nouvelle IHM de HAL
Recommandations pour la nouvelle IHM de HAL
 
HAL - Evolution du referentiel auteurs 2021
HAL - Evolution du referentiel auteurs 2021HAL - Evolution du referentiel auteurs 2021
HAL - Evolution du referentiel auteurs 2021
 
Deposer dans HAL
Deposer dans HALDeposer dans HAL
Deposer dans HAL
 
SciencesConf : plateforme de gestion de congres scientifiques
SciencesConf : plateforme de gestion de congres scientifiquesSciencesConf : plateforme de gestion de congres scientifiques
SciencesConf : plateforme de gestion de congres scientifiques
 
HAL : optimisation du referencement et de la diffusion des contenus
HAL : optimisation du referencement et de la diffusion des contenusHAL : optimisation du referencement et de la diffusion des contenus
HAL : optimisation du referencement et de la diffusion des contenus
 
La moderation dans HAL
La moderation dans HALLa moderation dans HAL
La moderation dans HAL
 
AUReHAL : referentiel des structures de recherche. Administration des donnees
AUReHAL : referentiel des structures de recherche. Administration des donneesAUReHAL : referentiel des structures de recherche. Administration des donnees
AUReHAL : referentiel des structures de recherche. Administration des donnees
 
Plugin HAL pour Wordpress
Plugin HAL pour WordpressPlugin HAL pour Wordpress
Plugin HAL pour Wordpress
 
TEI HAL - import SWORD
TEI HAL - import SWORDTEI HAL - import SWORD
TEI HAL - import SWORD
 
Utiliser HAL pour valoriser ses travaux et renforcer son identité numérique
Utiliser HAL pour valoriser ses travaux et renforcer son identité numériqueUtiliser HAL pour valoriser ses travaux et renforcer son identité numérique
Utiliser HAL pour valoriser ses travaux et renforcer son identité numérique
 
Episciences, an epijournal management platform
Episciences, an epijournal management platformEpisciences, an epijournal management platform
Episciences, an epijournal management platform
 
Comment diffuser mes données de recherche ?
Comment diffuser mes données de recherche ?Comment diffuser mes données de recherche ?
Comment diffuser mes données de recherche ?
 
Les epirevues avec Episciences
Les epirevues avec EpisciencesLes epirevues avec Episciences
Les epirevues avec Episciences
 
Panorama des identifiants auteurs
Panorama des identifiants auteursPanorama des identifiants auteurs
Panorama des identifiants auteurs
 
IdHAL et CV
IdHAL et CVIdHAL et CV
IdHAL et CV
 
Mes statistiques dans HAL
Mes statistiques dans HALMes statistiques dans HAL
Mes statistiques dans HAL
 
Bib2Hal, import par lot dans HAL à partir d'un fichier BibTeX -formation CCSD...
Bib2Hal, import par lot dans HAL à partir d'un fichier BibTeX -formation CCSD...Bib2Hal, import par lot dans HAL à partir d'un fichier BibTeX -formation CCSD...
Bib2Hal, import par lot dans HAL à partir d'un fichier BibTeX -formation CCSD...
 
Rechercher dans HAL et exploiter les résultats
Rechercher dans HAL et exploiter les résultatsRechercher dans HAL et exploiter les résultats
Rechercher dans HAL et exploiter les résultats
 

Les API de HAL