Obtenir le contenu des résultats
Récupère le contenu correspondant aux identifiants de résultats Mintlify ou aux URL de résultats renvoyés par le point de terminaison search. Une requête peut inclure jusqu’à 20 éléments répartis entre les deux champs.
curl --request POST \
--url https://leaves.mintlify.com/api/universal-search/v1/contents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ids": [
"nextjs:/docs/app/getting-started/caching-and-revalidating"
],
"query": "revalider les données mises en cache",
"maxCharacters": 12000
}
'import requests
url = "https://leaves.mintlify.com/api/universal-search/v1/contents"
payload = {
"ids": ["nextjs:/docs/app/getting-started/caching-and-revalidating"],
"query": "revalider les données mises en cache",
"maxCharacters": 12000
}
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({
ids: ['nextjs:/docs/app/getting-started/caching-and-revalidating'],
query: 'revalider les données mises en cache',
maxCharacters: 12000
})
};
fetch('https://leaves.mintlify.com/api/universal-search/v1/contents', 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/contents",
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([
'ids' => [
'nextjs:/docs/app/getting-started/caching-and-revalidating'
],
'query' => 'revalider les données mises en cache',
'maxCharacters' => 12000
]),
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/contents"
payload := strings.NewReader("{\n \"ids\": [\n \"nextjs:/docs/app/getting-started/caching-and-revalidating\"\n ],\n \"query\": \"revalider les données mises en cache\",\n \"maxCharacters\": 12000\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/contents")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"ids\": [\n \"nextjs:/docs/app/getting-started/caching-and-revalidating\"\n ],\n \"query\": \"revalider les données mises en cache\",\n \"maxCharacters\": 12000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://leaves.mintlify.com/api/universal-search/v1/contents")
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 \"ids\": [\n \"nextjs:/docs/app/getting-started/caching-and-revalidating\"\n ],\n \"query\": \"revalider les données mises en cache\",\n \"maxCharacters\": 12000\n}"
response = http.request(request)
puts response.read_body{
"requestId": "6bf694e4-76cb-4d31-a222-c94b2d9b198a",
"results": [
{
"id": "nextjs:/docs/app/getting-started/caching-and-revalidating",
"url": "https://nextjs.org/docs/app/getting-started/caching-and-revalidating",
"title": "Mise en cache et revalidation",
"text": "# Mise en cache et revalidation\n\nUtilisez les API de revalidation pour actualiser les données mises en cache.",
"truncated": false,
"totalCharacters": 78,
"score": 0,
"source": "mintlify",
"siteName": "nextjs",
"breadcrumbs": [
"Routeur App",
"Premiers pas"
],
"publishedDate": null
}
],
"statuses": [
{
"id": "nextjs:/docs/app/getting-started/caching-and-revalidating",
"status": "success"
}
]
}{
"error": "Une requête peut référencer au maximum 20 éléments entre urls et ids"
}{
"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
- Option 1
- Option 2
Fournissez au moins un identifiant de résultat Mintlify ou une URL de résultat. Vous pouvez combiner les deux champs, dans la limite de 20 éléments au total.
URL de résultats à récupérer. Utilisez ce champ pour les résultats web.
1 - 20 elementsIdentifiants de résultats Mintlify à récupérer.
1 - 20 elements1Nombre maximal de caractères de contenu à renvoyer par résultat.
x >= 1Requête utilisée pour sélectionner les sections les plus pertinentes lorsque le contenu dépasse maxCharacters.
1Réponse
Récupération du contenu terminée. Vérifiez chaque statut pour déterminer si l’élément correspondant a réussi.
curl --request POST \
--url https://leaves.mintlify.com/api/universal-search/v1/contents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ids": [
"nextjs:/docs/app/getting-started/caching-and-revalidating"
],
"query": "revalider les données mises en cache",
"maxCharacters": 12000
}
'import requests
url = "https://leaves.mintlify.com/api/universal-search/v1/contents"
payload = {
"ids": ["nextjs:/docs/app/getting-started/caching-and-revalidating"],
"query": "revalider les données mises en cache",
"maxCharacters": 12000
}
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({
ids: ['nextjs:/docs/app/getting-started/caching-and-revalidating'],
query: 'revalider les données mises en cache',
maxCharacters: 12000
})
};
fetch('https://leaves.mintlify.com/api/universal-search/v1/contents', 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/contents",
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([
'ids' => [
'nextjs:/docs/app/getting-started/caching-and-revalidating'
],
'query' => 'revalider les données mises en cache',
'maxCharacters' => 12000
]),
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/contents"
payload := strings.NewReader("{\n \"ids\": [\n \"nextjs:/docs/app/getting-started/caching-and-revalidating\"\n ],\n \"query\": \"revalider les données mises en cache\",\n \"maxCharacters\": 12000\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/contents")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"ids\": [\n \"nextjs:/docs/app/getting-started/caching-and-revalidating\"\n ],\n \"query\": \"revalider les données mises en cache\",\n \"maxCharacters\": 12000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://leaves.mintlify.com/api/universal-search/v1/contents")
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 \"ids\": [\n \"nextjs:/docs/app/getting-started/caching-and-revalidating\"\n ],\n \"query\": \"revalider les données mises en cache\",\n \"maxCharacters\": 12000\n}"
response = http.request(request)
puts response.read_body{
"requestId": "6bf694e4-76cb-4d31-a222-c94b2d9b198a",
"results": [
{
"id": "nextjs:/docs/app/getting-started/caching-and-revalidating",
"url": "https://nextjs.org/docs/app/getting-started/caching-and-revalidating",
"title": "Mise en cache et revalidation",
"text": "# Mise en cache et revalidation\n\nUtilisez les API de revalidation pour actualiser les données mises en cache.",
"truncated": false,
"totalCharacters": 78,
"score": 0,
"source": "mintlify",
"siteName": "nextjs",
"breadcrumbs": [
"Routeur App",
"Premiers pas"
],
"publishedDate": null
}
],
"statuses": [
{
"id": "nextjs:/docs/app/getting-started/caching-and-revalidating",
"status": "success"
}
]
}{
"error": "Une requête peut référencer au maximum 20 éléments entre urls et ids"
}{
"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>"
}