Autocomplétion sur le nom
const url = 'https://api-equides.org/v1/search?q=invictus%20du%20f&limite=10';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}use reqwest;
#[tokio::main]pub async fn main() { let url = "https://api-equides.org/v1/search";
let querystring = [ ("q", "invictus du f"), ("limite", "10"), ];
let client = reqwest::Client::new(); let response = client.get(url) .query(&querystring) .send() .await;
let results = response.unwrap() .json::<serde_json::Value>() .await .unwrap();
dbg!(results);}curl --request GET \ --url 'https://api-equides.org/v1/search?q=invictus%20du%20f&limite=10'Renvoie des suggestions classées par pertinence, pour alimenter un champ de saisie.
À distinguer de /v1/equides?nom=…, qui filtre et pagine sans classer. Ici le coût est borné par limite et non par la popularité du préfixe : la réponse doit arriver avant la frappe suivante.
Parameters
Section intitulée « Parameters »Query Parameters
Section intitulée « Query Parameters »Début de nom, insensible à la casse et aux accents. Obligatoire et non vide.
Les espaces comptent : chaque mot déjà saisi doit se retrouver dans le nom, seul le dernier est traité comme un début de mot. INVICTUS DU F ne suggère donc que des noms portant INVICTUS, DU, et un mot commençant par F.
Example
invictus du fNombre de suggestions (1 à 100, défaut 10). Une valeur hors bornes est ramenée au plafond, non refusée.
Example
10Responses
Section intitulée « Responses »Suggestions, de la plus pertinente à la moins.
object
Requête telle que reçue, pour que le client sache à quoi la réponse répond — les frappes arrivent dans le désordre.
De la suggestion la plus pertinente à la moins.
object
Pertinence dans [0, 1] ; 1 pour une correspondance exacte de mot.
Examplegenerated
{ "limite": 1, "q": "example", "resultats": [ { "annee_naissance": 1, "id": "example", "nom": "example", "race": "example", "score": 1, "sexe": "example" } ]}Contenu inchangé depuis l’ETag fourni en If-None-Match. Aucun corps, et rien n’est recalculé côté service.
q manquant ou vide, ou paramètre inconnu.
Corps d’erreur conforme à la RFC 9457 (« Problem Details for HTTP APIs »), servi en application/problem+json. Les champs parametre et indice sont des extensions, que la RFC autorise.
object
Explication propre à cette occurrence.
Extension : piste de correction — valeurs admises, référentiel à consulter, ou paramètre le plus proche en cas de faute de frappe.
Extension : paramètre fautif, quand l’erreur en désigne un.
Résumé lisible, stable pour un type donné.
URI du type de problème, relative — le client la résout contre l’URI de la requête. Elle pointe vers la section correspondante de la documentation.
Example
{ "detail": "paramètre inconnu `rase`", "documentation": "https://docs.api-equides.org", "indice": "vouliez-vous dire `race` ?", "parametre": "rase", "status": 400, "title": "Paramètre invalide", "type": "/#erreur-parametre-invalide"}Quota de débit dépassé pour l’adresse appelante. Retry-After indique le délai.
Corps d’erreur conforme à la RFC 9457 (« Problem Details for HTTP APIs »), servi en application/problem+json. Les champs parametre et indice sont des extensions, que la RFC autorise.
object
Explication propre à cette occurrence.
Extension : piste de correction — valeurs admises, référentiel à consulter, ou paramètre le plus proche en cas de faute de frappe.
Extension : paramètre fautif, quand l’erreur en désigne un.
Résumé lisible, stable pour un type donné.
URI du type de problème, relative — le client la résout contre l’URI de la requête. Elle pointe vers la section correspondante de la documentation.
Example
{ "detail": "paramètre inconnu `rase`", "documentation": "https://docs.api-equides.org", "indice": "vouliez-vous dire `race` ?", "parametre": "rase", "status": 400, "title": "Paramètre invalide", "type": "/#erreur-parametre-invalide"}Capacité de traitement simultané atteinte, délai maximal dépassé, ou données non chargées. Retry-After indique le délai.
Corps d’erreur conforme à la RFC 9457 (« Problem Details for HTTP APIs »), servi en application/problem+json. Les champs parametre et indice sont des extensions, que la RFC autorise.
object
Explication propre à cette occurrence.
Extension : piste de correction — valeurs admises, référentiel à consulter, ou paramètre le plus proche en cas de faute de frappe.
Extension : paramètre fautif, quand l’erreur en désigne un.
Résumé lisible, stable pour un type donné.
URI du type de problème, relative — le client la résout contre l’URI de la requête. Elle pointe vers la section correspondante de la documentation.
Example
{ "detail": "paramètre inconnu `rase`", "documentation": "https://docs.api-equides.org", "indice": "vouliez-vous dire `race` ?", "parametre": "rase", "status": 400, "title": "Paramètre invalide", "type": "/#erreur-parametre-invalide"}