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 GET vers le point de terminaison de l’API
  • DĂ©finissez le paramĂštre de requĂȘte api_key avec 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 path avec le chemin du blog pour lequel vous souhaitez obtenir des informations. Par exemple, si vous voulez obtenir des informations sur https://myblog.com/hello-world, dĂ©finissez path sur /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
type
string
file ou redirect
at
integer
Horodatage UNIX de la création de l'objet
cache
boolean
Indique 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.
status
integer
Code de statut HTTP de la rĂ©ponse. Peut ĂȘtre 200, 301, 302, ou 404.

Propriétés du fichier :

Clé
Type
Description
file_type
string
template, asset, ou media
content
string
Contenu du fichier encodé en Base64
mime_type
string
Type MIME du fichier (pour l'en-tĂȘte Content-Type)
cache_control
string
Valeur de l'en-tĂȘte HTTP Cache-Control

Propriétés de redirection :

Clé
Type
Description
to
string
URL vers laquelle rediriger