Démarrer une tâche d'exportation statique

Lance une tâche d’export statique pour un déploiement. La tâche pré-rend votre documentation sous la forme d’un ensemble autonome de fichiers HTML, RSC et ressources statiques. Retourne un identifiant de tâche que vous pouvez utiliser pour interroger le statut et, une fois la tâche terminée, générer un paquet téléchargeable.

L’export statique est disponible sur les plans Enterprise.

POST /static-export/jobs

Lancer une tâche d’export statique

cURL

curl --request POST \
  --url https://api.mintlify.com/v1/static-export/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "docs.example.com",
  "version": "2024-06-01",
  "paths": [
    "index",
    "guides/getting-started",
    "api-reference/introduction"
  ]
}
'

202

{
  "jobId": "se_3f9a2c1b8e7d4a06",
  "status": "running",
  "progress": 42,
  "pageCount": 128,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "error": "<string>"
}

L’exportation statique nécessite un forfait Enterprise.

Autorisations

Authorization · string · header · requis

Clé d’API administrateur. Générez-en une sur la page des clés d’API de votre Dashboard.

Corps

application/json

domain · string · requis

Le domaine du déploiement à exporter, par exemple docs.example.com.

Exemple:

"docs.example.com"

version · string

Un libellé de version facultatif pour identifier cet export. Par défaut, il s’agit de la dernière version publiée.

Exemple:

"2024-06-01"

paths · string[]

Une liste facultative de chemins de page à inclure. Si elle est omise, toutes les pages publiées sont exportées.

Exemple:

[
  "index",
  "guides/getting-started",
  "api-reference/introduction"
]

Réponse

202

application/json

La tâche d’export a été acceptée et mise en file d’attente.

jobId · string · requis

Identifiant unique de la tâche d’export statique.

Exemple:

"se_3f9a2c1b8e7d4a06"

status · enum<string> · requis

L’état actuel de la tâche.

Options disponibles: queued, running, completed, failed

Exemple:

"running"

progress · number · requis

Pourcentage d’avancement de 0 à 100.

Plage requise: 0 <= x <= 100

Exemple:

42

pageCount · integer · requis

Le nombre de pages exportées jusqu’à présent.

Exemple:

128

createdAt · string<date-time> · requis

Date de création de la tâche.

updatedAt · string<date-time> · requis

Date de la dernière mise à jour de la tâche.

error · string | null

Un message d’erreur lisible par un humain. Présent uniquement lorsque status est failed.