Table des matières
type = fiche
Cette requête JSON permet de récupérer une liste de fiches suivant certains critères. Si le paramètre fichelist est utilisé, les autres paramètres sont ignorés, sinon ce sont des paramètres équivalents à ceux la recherche de fiches. Si aucun paramètre n'est indiqué, la requête renvoie l'intégralité des fiches.
Paramètres
Paramètres communs obligatoires
- version : version à utiliser (Version actuelle : 3)
Paramètres communs optionnels
- lang : langue à utiliser de préférence pour les intitulés
- langlist : limitation des fiches à certaines langues (ignoré si fichelist est défini)
- baselist : limitation des fiches à certaines bases (ignoré si fichelist est défini)
- corpuslist : limitation des fiches à certains corpus (ignoré si fichelist est défini)
- categorylist : limitation des fiches aux corpus appartenant aux catégories indiquées (ignoré si fichelist est défini)
- fichefields : détermine les champs à transmettre (voir Champs des fiches), si le paramètre contient codemotclearray, les mots-clés indexant la fiche sont également transmis
- fieldvariant : variante de champs à utiliser (voir le fichier fields.xml et Champs des fiches) (ignoré si fichefields est défini)
Paramètres spécifiques optionnels
- fichelist : liste de codes de fiches, s'il est présent les autres paramètres sont ignorés
- flt (flt-*) : filtres établissant la sélection de fiches (voir Syntaxe des filtres)
- ignore : la valeur alternate indique que les fiches qui sont des traductions d'autres fiches également sélectionnées (et dans la langue principales) sont ignorées
- insert : la valeur motclearray indique qu'il faut ajouter le tableau des mots-clés dont les codes seront dans codemotcleArray d'une fiche, l'argument n'est pas pris en compte si codemotcleArray ne fait pas partie des champs d'une fiche
- random : vaut - 1 ou un entier strictement positif, indique le nombre de fiches qu'il faut conserver après les filtres, ces fiches sont sélectionnées aléatoirement ; si la valeur est -1, toutes les fiches sont retournées classées de façon aléatoire
Objet retourné
Version 3 et 2 :
{ ficheArray: [ // tableau des fiches { // chaque fiche est un objet __fiche-fields__ // série de propriétés définies par le paramètre fichefields } ], motcleArray : [ // tableau des mots-clés si insert=motcleArray { // chaque mot-clé est un objet ... // construit de manière identique à motcleArray de type=motcle } }
Version 1 (ficheArray était encapsulé dans un objet ficheData) :
{ ficheData: { ficheCount: … , //(nombre total de fiches), ficheArray: [ // tableau des fiches { // chaque fiche est un objet __fiche-fields__ // série de propriétés définies par le paramètre fichefields, codemotcleArray: [...] // tableau des codes des mots-clés indexant la fiche (tableau d'entiers > 0), si codemotclearray est indiqué dans fichefields ou dans la variante précisée par fieldvariant } ] } }