Construire le contexte d’implémentation
Recherche dans Mintlify Index et renvoie du contenu accompagné de ses sources, assemblé dans une limite de jetons. Utilisez ce point de terminaison lorsqu’une application ou un agent a besoin d’un contexte prêt à l’emploi en une seule requête.
curl --request POST \
--url https://leaves.mintlify.com/api/universal-search/v1/context \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "Comment dois-je configurer la mise en cache dans Next.js 16 ?",
"product": "Next.js",
"format": "txt",
"tokenBudget": 3000
}
'import requests
url = "https://leaves.mintlify.com/api/universal-search/v1/context"
payload = {
"query": "Comment dois-je configurer la mise en cache dans Next.js 16 ?",
"product": "Next.js",
"format": "txt",
"tokenBudget": 3000
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: 'Comment dois-je configurer la mise en cache dans Next.js 16 ?',
product: 'Next.js',
format: 'txt',
tokenBudget: 3000
})
};
fetch('https://leaves.mintlify.com/api/universal-search/v1/context', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://leaves.mintlify.com/api/universal-search/v1/context",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'Comment dois-je configurer la mise en cache dans Next.js 16 ?',
'product' => 'Next.js',
'format' => 'txt',
'tokenBudget' => 3000
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://leaves.mintlify.com/api/universal-search/v1/context"
payload := strings.NewReader("{\n \"query\": \"Comment dois-je configurer la mise en cache dans Next.js 16 ?\",\n \"product\": \"Next.js\",\n \"format\": \"txt\",\n \"tokenBudget\": 3000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://leaves.mintlify.com/api/universal-search/v1/context")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"Comment dois-je configurer la mise en cache dans Next.js 16 ?\",\n \"product\": \"Next.js\",\n \"format\": \"txt\",\n \"tokenBudget\": 3000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://leaves.mintlify.com/api/universal-search/v1/context")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"Comment dois-je configurer la mise en cache dans Next.js 16 ?\",\n \"product\": \"Next.js\",\n \"format\": \"txt\",\n \"tokenBudget\": 3000\n}"
response = http.request(request)
puts response.read_body{
"requestId": "7f2ab8d1-3bea-4a29-bc51-c05a8d3a3e3c",
"query": "Comment dois-je configurer la mise en cache dans Next.js 16 ?",
"response": "### Mise en cache et revalidation\n\nSource: https://nextjs.org/docs/app/getting-started/caching-and-revalidating\n\nUtilisez les API de mise en cache actuelles décrites dans ce guide.\n\n--------------------------------",
"resultsCount": 3,
"outputTokens": 1842
}{
"error": "Corps de requête invalide"
}{
"error": "Non autorisé"
}{
"error": "L’adresse IP n’est pas autorisée pour cette clé d’API"
}{
"error": "Limite de débit dépassée. Veuillez réessayer plus tard"
}{
"error": "<string>"
}Autorisations
Clé d’API Mintlify Index avec le préfixe mint_us_.
Corps
Question d’implémentation à étudier.
1Format de la chaîne response. txt renvoie des sections Markdown. json renvoie un objet JSON sérialisé contenant les éléments de résultat.
txt, json Nom du produit ou de l’entreprise à utiliser comme indication de récupération supplémentaire.
1Domaines à inclure dans la récupération.
11Domaines à exclure de la récupération.
11Nombre maximal de jetons en sortie.
1 <= x <= 6000Réponse
Contexte assemblé avec succès.
Identifiant unique de la requête.
Requête d’origine.
Contenu source assemblé. La valeur est au format Markdown pour les requêtes txt et au format JSON sérialisé pour les requêtes json. La chaîne peut être vide lorsqu’aucun contenu ne tient dans la limite de jetons.
Nombre d’extraits de sources inclus dans la réponse.
x >= 0Nombre de jetons dans la réponse assemblée.
x >= 0Sujets connexes
Vue d'ensemble des automatisationsRéférence des commandes de la CLI MintlifyAssistantcurl --request POST \
--url https://leaves.mintlify.com/api/universal-search/v1/context \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "Comment dois-je configurer la mise en cache dans Next.js 16 ?",
"product": "Next.js",
"format": "txt",
"tokenBudget": 3000
}
'import requests
url = "https://leaves.mintlify.com/api/universal-search/v1/context"
payload = {
"query": "Comment dois-je configurer la mise en cache dans Next.js 16 ?",
"product": "Next.js",
"format": "txt",
"tokenBudget": 3000
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: 'Comment dois-je configurer la mise en cache dans Next.js 16 ?',
product: 'Next.js',
format: 'txt',
tokenBudget: 3000
})
};
fetch('https://leaves.mintlify.com/api/universal-search/v1/context', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://leaves.mintlify.com/api/universal-search/v1/context",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'Comment dois-je configurer la mise en cache dans Next.js 16 ?',
'product' => 'Next.js',
'format' => 'txt',
'tokenBudget' => 3000
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://leaves.mintlify.com/api/universal-search/v1/context"
payload := strings.NewReader("{\n \"query\": \"Comment dois-je configurer la mise en cache dans Next.js 16 ?\",\n \"product\": \"Next.js\",\n \"format\": \"txt\",\n \"tokenBudget\": 3000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://leaves.mintlify.com/api/universal-search/v1/context")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"Comment dois-je configurer la mise en cache dans Next.js 16 ?\",\n \"product\": \"Next.js\",\n \"format\": \"txt\",\n \"tokenBudget\": 3000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://leaves.mintlify.com/api/universal-search/v1/context")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"Comment dois-je configurer la mise en cache dans Next.js 16 ?\",\n \"product\": \"Next.js\",\n \"format\": \"txt\",\n \"tokenBudget\": 3000\n}"
response = http.request(request)
puts response.read_body{
"requestId": "7f2ab8d1-3bea-4a29-bc51-c05a8d3a3e3c",
"query": "Comment dois-je configurer la mise en cache dans Next.js 16 ?",
"response": "### Mise en cache et revalidation\n\nSource: https://nextjs.org/docs/app/getting-started/caching-and-revalidating\n\nUtilisez les API de mise en cache actuelles décrites dans ce guide.\n\n--------------------------------",
"resultsCount": 3,
"outputTokens": 1842
}{
"error": "Corps de requête invalide"
}{
"error": "Non autorisé"
}{
"error": "L’adresse IP n’est pas autorisée pour cette clé d’API"
}{
"error": "Limite de débit dépassée. Veuillez réessayer plus tard"
}{
"error": "<string>"
}