Obtenir le contenu de la page
Récupère le contenu textuel complet d’une page de documentation spécifique par son chemin. Utilisez-le après une recherche pour obtenir le contenu complet d’une page correspondante.
Authentifiez-vous avec une clé d’API assistant. Les requêtes de contenu de page ne consomment pas de crédits.
curl --request POST \
--url https://api.mintlify.com/discovery/v1/page/{domain} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "<string>",
"groups": [
"<string>"
]
}
'import requests
url = "https://api.mintlify.com/discovery/v1/page/{domain}"
payload = {
"path": "<string>",
"groups": ["<string>"]
}
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({path: '<string>', groups: ['<string>']})
};
fetch('https://api.mintlify.com/discovery/v1/page/{domain}', 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://api.mintlify.com/discovery/v1/page/{domain}",
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([
'path' => '<string>',
'groups' => [
'<string>'
]
]),
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://api.mintlify.com/discovery/v1/page/{domain}"
payload := strings.NewReader("{\n \"path\": \"<string>\",\n \"groups\": [\n \"<string>\"\n ]\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://api.mintlify.com/discovery/v1/page/{domain}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"path\": \"<string>\",\n \"groups\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mintlify.com/discovery/v1/page/{domain}")
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 \"path\": \"<string>\",\n \"groups\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"path": "<string>",
"content": "<string>"
}{
"message": "<string>"
}Limites de débit
- 10 000 requêtes par organisation Mintlify par heure
Autorisations
L'en-tête Authorization attend un jeton Bearer. Utilisez une clé d'API assistant. Générez-en une depuis la page des clés d'API de votre Dashboard. En production, faites transiter les requêtes par votre backend plutôt que d'intégrer la clé dans du code côté client.
Paramètres de chemin
L'identifiant domain de votre URL domain.mintlify.site. Il se trouve à la fin de l'URL de votre Dashboard. Par exemple, dashboard.mintlify.com/organization/domain a un identifiant domain de domain.
Corps
Le slug ou chemin de la page dont le contenu doit être récupéré. Cela correspond au champ path renvoyé par l'endpoint Search documentation.
Groupes de documentation facultatifs qui restreignent les résultats. La clé d'API de l'Assistant peut lire tout le contenu, y compris les pages protégées. Si ce champ est omis ou vide, les résultats incluent les pages protégées. Mintlify ne vérifie pas l'appartenance aux groupes ; votre backend doit donc choisir les groupes pour chaque utilisateur. Sur les déploiements protégés par mot de passe, groups ne restreint rien.
curl --request POST \
--url https://api.mintlify.com/discovery/v1/page/{domain} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"path": "<string>",
"groups": [
"<string>"
]
}
'import requests
url = "https://api.mintlify.com/discovery/v1/page/{domain}"
payload = {
"path": "<string>",
"groups": ["<string>"]
}
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({path: '<string>', groups: ['<string>']})
};
fetch('https://api.mintlify.com/discovery/v1/page/{domain}', 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://api.mintlify.com/discovery/v1/page/{domain}",
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([
'path' => '<string>',
'groups' => [
'<string>'
]
]),
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://api.mintlify.com/discovery/v1/page/{domain}"
payload := strings.NewReader("{\n \"path\": \"<string>\",\n \"groups\": [\n \"<string>\"\n ]\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://api.mintlify.com/discovery/v1/page/{domain}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"path\": \"<string>\",\n \"groups\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mintlify.com/discovery/v1/page/{domain}")
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 \"path\": \"<string>\",\n \"groups\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"path": "<string>",
"content": "<string>"
}{
"message": "<string>"
}