Заголовки содержат всю информацию о сообщении, кроме его содержимого: кто звонит (Authorization), в каком формате находится тело сообщения (Content-Type), какой формат запрашивает клиент (Accept), как долго оно может храниться в кэше (Cache-Control), какая у него версия (ETag) и когда следует повторить попытку (Retry-After). Имена нечувствительны к регистру; значения представляют собой текст.
Запрос или ответ состоит из начальной строки, затем заголовков (по одному на строку), пустой строки и тела. Промежуточные посредники считывают и добавляют заголовки, не затрагивая тело — прокси добавляет Via, балансировщик нагрузки — X-Forwarded-For, CDN — собственный статус кэша. Многие действия, которые выглядят как функции API, на самом деле являются соглашениями об использовании заголовков.
Этой проверки тела достаточно. Некоторые из наиболее существенных ошибок скрываются только в заголовках: отсутствие Location после 201-го кода, Cache-Control, позволяющий кэшировать частный ответ CDN, Content-Type со значением text/html в теле JSON-запроса. Они проходят проверку каждого параметра тела запроса.
В панели документации каждый ответ отображает свои заголовки рядом с телом, и язык утверждений считывает их вместе с заголовками.<name> — try headers.etag exists on GET /football/v1/standings.
Все термины · Приёмы тестирования · Все 39 mock REST API
Последнее обновление