Notes Hélène

== Notes prises sur la DOC recherche HAL pour mémoire : https://api.archives-ouvertes.fr/docs/search

• Il faut au moins un paramètre dans l'URL pour faire une requête, ce paramètre est q
• Ce paramètre contient la requête à effectuer.
• Le paramètre doit être suivi du nom du champ dans lequel rechercher puis de la valeur à chercher.
• Si le nom du champ dans lequel chercher est omis, par défaut la recherche porte sur l'index text qui contient les valeurs de plusieurs champs.
• Pour chercher dans un champ particulier la syntaxe est champ:terme
• Pour chercher plusieurs champs, utiliser (terme1 terme2). L'opérateur booléen par défaut est AND
• Pour OR : Utiliser (terme1 OR terme2)
• Pour une phrase : Utiliser les guillemets doubles "phrase"
• Troncature ? * ~ proximité

//

• Le format de réponse par défaut est JSON
• Le format de réponse est spécifié par le paramètre wt : wt=json
• liste des formats dans la doc. Ajouter indent=true pour indenter le format de réponse.

//

• Par défaut seuls les champs docid et label_s sont retournés dans une réponse. Cependant tous les champs stockés peuvent être retournés dans le format de réponse
• Le paramètre pour choisir les champs à retourner est fl. Les champs demandés doivent être séparés par le signe ,
• Formats de sortie avec fl = JSON, XML et CSV uniquement
• On peut utiliser le caractère * comme troncature de nom de champ, eg fl=cha*

*fl=* signifie tous les champs possibles //

• Par défaut, les résultats sont triés par pertinence.
• Le tri des résultats peut se faire sur n'importe quel champ en évitant les champs de type text (suffixe "_t") et les champs multi-valués qui donneront des résultats imprévisibles.
• Le paramètre pour choisir les champs à retourner est sort + le sens de tri asc ou desc

//

• Le paramètre pour ajouter des filtres est fq suivi de la requête servant au filtre : fq=submitType_s:file
• Il est possible de faire des requêtes sur des intervalles avec cette syntaxe champ:[valeurDébut TO valeurFin]
• valeur maximale = * + doc pour les spécificités des calculs de dates

//

• Le nombre de réponses à retourner est définit par le paramètre rows .
• Le nombre total de dépôt/notices ne change pas avec ce paramètres, seul le nombre de résultats effectivement retournés varie.
• Par défaut les requêtes ne retournent que les 30 premiers résultats, le maximum autorisé est 10000. Si vous souhaitez plus de résultats vous devez utiliser la pagination.
• Le paramètre &rows=0 peut permettre de ne retourner que le nombre de résultats et d'enlever les documents du corps de la réponse. Vous pouvez par exemple utiliser ce paramètre à des fins de statistiques ou si vous voulez retourner uniquement des facettes.

//

• pagination : afficher 50 après les 50 1ers : start=50&rows=50
• Curseurs : si vous devez parcourir plusieurs milliers de résultats, pour des raisons de performance il est fortement recommandé d'utiliser les curseurs

//

• Les facettes sont des listes de termes extraits en fonction d'une requête.
• On peut les utiliser pour avoir une liste de valeurs distinctes sur un champ donné.
• Pour générer des facettes, il faut ajouter le paramètre facet=true à une requête.
• Il faut ensuite ajouter les champs avec lesquel construire les facettes avec le paramètre facet.field=NomDuChamp à une requête.
• facet.sort=index, count, prefix, contains (facet.contains.ignoreCase=true)
• Pivots
• plage de résultats

//

• Vous pouvez obtenir vos résultats de requêtes groupés selon un critère de votre choix, à condition que le critère soit représenté par un champ non multivalué et de type string.