API de livraison
L’API de livraison vous fournit des informations sur la façon de « servir une requête ». Cette API est le pilier de l’hébergement d’un blog sur un sous-répertoire.
Point de terminaison de l’API : https://blogs.hyvor.com/api/delivery/v0/{subdomain}
Remplacez {subdomain} par le sous-domaine de votre blog.
Requête
- Requête
GETvers le point de terminaison de l’API - Définissez le paramètre de requête
api_keyavec une clé API de livraison valide. Vous pouvez en créer une dans Paramètres → Clés API. - Définissez le paramètre de requête
pathavec le chemin du blog pour lequel vous souhaitez obtenir des informations. Par exemple, si vous voulez obtenir des informations surhttps://myblog.com/hello-world, définissezpathsur/hello-world/.
Réponse
Une réponse réussie sera l’un des objets JSON suivants :
1. Fichier
Cet objet est renvoyé lorsque le chemin correspond à un fichier.
{
"type": "file",
"at": 1661590503,
"cache": true,
"status": 200,
"file_type": "template",
"content": "SGVsbG8gV29ybGQ=",
"mime_type": "text/html",
"cache_control": "no-cache, private"
}2. Redirection
Cet objet est renvoyé lorsque le chemin correspond à une redirection.
{
"type": "redirect",
"at": 1661590503,
"cache": true,
"status": 301,
"to": "https://example.com"
}Propriétés communes :
Clé
Type
Description
typestringfile ou redirectatintegerHorodatage UNIX de la création de l'objet
cachebooleanIndique si l'objet de réponse doit être mis en cache dans les serveurs proxy/intermédiaires.
false pour
les routes d'aperçu d'article.statusintegerCode de statut HTTP de la réponse. Peut être
200, 301, 302, ou 404.Propriétés du fichier :
Clé
Type
Description
file_typestringtemplate, asset, ou mediacontentstringContenu du fichier encodé en Base64
mime_typestringType MIME du fichier (pour l'en-tête Content-Type)
cache_controlstringValeur de l'en-tête HTTP Cache-Control
Propriétés de redirection :
Clé
Type
Description
tostringURL vers laquelle rediriger