Accept-Ranges

Utilisation

L’en-tête Accept-Ranges indique aux clients que le serveur accepte les requêtes Range, ce qui permet le téléchargement partiel d’une ressource. C’est indispensable pour reprendre un transfert de fichier interrompu, diffuser un média à partir d’une position donnée et récupérer à la demande des segments de fichiers volumineux.

Lorsqu’un client envoie une requête Range, le serveur renvoie une réponse 206 Partial Content contenant uniquement le segment d’octets demandé. L’en-tête de réponse Content-Range précise la plage d’octets exacte et la taille totale de la ressource.

Si la plage demandée est invalide ou dépasse les limites de la ressource, le serveur répond 416 Range Not Satisfiable.

bytes

Le serveur accepte les requêtes par plage d’octets. C’est la seule unité de plage définie par HTTP et la valeur la plus courante de cet en-tête.

none

Le serveur ne prend pas en charge les requêtes de plage pour cette ressource. Envoyer none signale explicitement aux clients de ne pas tenter de requêtes de plage.

Exemple

Un serveur indiquant la prise en charge des requêtes par plage d’octets. Les gestionnaires de téléchargement et les lecteurs multimédias se servent de ce signal pour demander des portions précises d’un fichier.

Accept-Ranges: bytes

Un serveur désactivant explicitement les requêtes de plage. Les clients qui reçoivent cette valeur téléchargent la ressource entière en une seule requête.

Accept-Ranges: none

Une réponse typique pour un fichier téléchargeable, associant l’indicateur de prise en charge des plages à la longueur du contenu. Un client interrompu à l’octet 5000 reprend à partir du point d’échec.

HTTP/1.1 200 OK
Accept-Ranges: bytes
Content-Length: 1048576
Content-Type: application/octet-stream