Récupérer une liste de résultats via l'API⚓

Les différents paramètres de l’API sont :

•  ?q= : lancement de la requête

• debut= : numéro de la première thèse du lot de thèse à afficher ou exporter

• nombre= : nombre de thèses contenues dans le lot à exporter

• tri= : la façon dont sont triés les résultats

  • pertinence
  • dateAsc = date croissante
  • dateDesc = date décroissante
  • auteursAsc = auteurs A-Z
  • auteursDesc = auteurs Z-A
  • disciplineAsc = discipline A-Z
  • disciplineDesc = discipline Z-A
  • personnesAsc = personnes A-Z
  • personnesDesc = personnes Z-A

• filtres=[] : paramétrage des filtres (apparaît uniquement lorsque des filtres ont été activés dans l’interface de theses.fr)

Les paramètres sont articulés entre eux par le symbole &.

Dans le paramètre query (q=), vous pouvez interroger les champs de recherche listés sur la page : Les champs interrogeables.

A l’intérieur d’une même requête, vous pouvez interroger simultanément plusieurs champs de l’index. Les champs sont articulés entre eux par des opérateurs booléens AND, OR ou AND NOT, encadrés par des espaces encodés (%20).

Le moteur de recherche Elastic Search utilise les caractères suivants comme caractères signifiants : + - && || ! ( ) { } [ ] ^ " ~ * ? : \

Si vous saisissez ces caractères dans les valeurs des différents champs de recherche ou des filtres, votre requête ne pourra pas être comprise. Vous devrez au préalable les échapper, en les faisant précéder du caractère spécial \ (%5C).

• status:(*) = toutes les thèses

• status:(soutenue) = uniquement les thèses soutenues

• accessible:oui = les thèses accessibles en ligne

• status:(enCours) = uniquement les thèses en cours

• datePremiereInscriptionDoctorat:() : date de première inscription en doctorat

• dateSoutenance:() : date de soutenance

• dateInsertionDansES:() : date de dernière mise à jour des données de la thèse dans l’index

Les dates sont enregistrées entre parenthèses sous la forme :

• pour une année donnée : AAAA. Cette requête fonctionne uniquement pour les thèses imprimées, dont la date de soutenance est enregistrée sous la forme AAAA-01-01 dans la base de données (seule l’année de soutenance est connue)

• pour une date donnée : AAAA-MM-JJ

• pour une période donnée : [AAAA-MM-JJ TO AAAA-MM-JJ]

• titrePrincipal:(XXX) : titre principal de la thèse

• sujetsLibelle:(XXX) : mots-clés libres par libellé

• sujetsRameauLibelle:(XXX) : mots-clés contrôlés par libellé

• sujetsRameauPpn:(XXX) : mots-clés contrôlés par identifiant

• resumes.\*:(XXX) : résumés. Il est possible de spécifier la langue des résumés dans lesquels la recherche doit être effectuée, sous la forme resumes.XX:() où XX correspond au code ISO 639-1 de la langue concernée.

• discipline:(XXX) : discipline

• auteursNP:(XXX) : nom et/ou prénom de l’auteur(s)

• auteursPpn:(XXX) : identifiant de l’auteur(s)

• directeursNP:(XXX) : nom et/ou prénom du/des directeur(s)

• directeursPpn:(XXX) : identifiant du/des directeur(s)

• presidentJuryNP:(XXX) : nom et/ou prénom du président du jury

• presidentJuryPpn:(XXX) : identifiant du président du jury

• rapporteursNP:(XXX) : nom et/ou prénom du/des rapporteur(s)

• rapporteursPpn:(XXX) : identifiant  du/des rapporteur(s)

• membresJuryNP:(XXX) : nom et/ou prénom du/des examinateurs

• membresJuryPpn:(XXX) : identifiant du/des examinateurs

• etabSoutenanceN:(XXX) : nom de l’établissement de soutenance

• etabSoutenancePpn:(XXX) : identifiant de l’établissement de soutenance par identifiant

• etabsCotutelleN:(XXX) : nom de l’établissement de cotutelle

• etabsCotutellePpn:(XXX) : : identifiant de l’établissement de cotutelle

• ecolesDoctoralesN:(XXX) : nom de l’école(s) doctorale(s)

• ecolesDoctoralesPpn:(XXX) : : identifiant de la ou les école(s) doctorale(s)

• partenairesRechercheN:(XXX) : nom du ou des partenaire(s) de recherche

• partenairesRecherchePpn:(XXX) : : identifiant du/des partenaire(s) de recherche

• nnt:(XXXXXXXXXXXX) : numéro national de la thèse, sur 12 caractères

• numSujet:(sXXXXX) : identifiant du projet de thèse dans la base de données STEP, avec le préfixe s

• numSujetSansS:(XXXXX) : identifiant du projet de thèse dans la base de données STEP, sans le préfixe s

• codeEtab:(XXXX) : code court de l’établissement, sur 4 caractères. Voir la liste des codes courts : /sudoc/regles/CodesUnivEtab.htm

• oaiSetNames:(XXXXXXXX) :  domaine thématique de la thèse, correspondant à l’une des valeurs de la liste : https://theses.fr/schemas/tef/recommandation/tef_oai_setSpec.html

• langues:(XX) : langue de la thèse, sur deux caractères composant le code ISO 639-1 de la langue sélectionnée.