Заголовок HTTP Want-Content-Digest запроса и ответа указывает на предпочтение получателя получать заголовок целостности Content-Digest в сообщениях, связанных с URI запроса и метаданными представления.

Заголовок содержит предпочтения в отношении алгоритмов хеширования, которые получатель может использовать в последующих сообщениях. Эти предпочтения служат лишь подсказкой: получатель может игнорировать выбор алгоритмов или полностью отказаться от заголовков целостности.

Некоторые реализации могут отправлять незапрошенные заголовки Content-Digest без требования заголовка Want-Content-Digest в предыдущем сообщении.

Синтаксис

Want-Content-Digest: <algorithm>=<preference>
Want-Content-Digest: <algorithm>=<preference>, …, <algorithmN>=<preferenceN>

Директивы

<algorithm>

Запрошенный алгоритм для создания дайджеста содержимого сообщения. Безопасными считаются только два зарегистрированных алгоритма дайджестов: sha-512 и sha-256. К небезопасным (устаревшим) зарегистрированным алгоритмам дайджестов относятся: md5, sha (SHA-1), unixsum, unixcksum, adler (ADLER32) и crc32c.

<preference>

Целое число от 0 до 9, где 0 означает «неприемлемо», а значения от 1 до 9 задают возрастающее относительное предпочтение с весами. В отличие от предыдущих редакций спецификаций, вес не указывается с помощью q значений качества.

Примеры

Использование Want-Content-Digest в запросах

Следующее сообщение просит получателя отправить заголовок Content-Digest с использованием алгоритма SHA-512:

Want-Content-Digest: sha-512=9

Want-Content-Digest с несколькими значениями

Следующий заголовок содержит три алгоритма и указывает, что предпочтительным алгоритмом дайджеста, который следует использовать получателю, является SHA-256, за ним следуют SHA-512 и MD5:

Want-Content-Digest: md5=1, sha-512=2, sha-256=3

Спецификации

Совместимость с браузерами

Этот заголовок не имеет интеграции с браузерами, определённой спецификацией (понятие «совместимость с браузерами» здесь неприменимо). Разработчики могут задавать и получать заголовки HTTP с помощью fetch() для реализации поведения, специфичного для приложения.

См. также

• Заголовки дайджестов Content-Digest, Repr-Digest, Want-Repr-Digest
• Цифровые подписи для API: в руководстве по SDK используются Content-Digests для цифровых подписей в вызовах HTTP (developer.ebay.com)