Версия источника: 4880e8b4372c96001c2e052be28b68a95d31252b
Синхронизировано: 2026-11-09T11:15:07.649Z
Источник: https://github.com/sergey-from-riders/vibecoding-base/tree/4880e8b4372c96001c2e052be28b68a95d31252b

<a id="api-headers"></a>

# HTTP-заголовки

## Коротко

Статус, формат содержимого и кеширование описываются стандартными средствами HTTP.

## Плохо

```http
HTTP 200
X-App-Result: error
```

## Хорошо

```http
HTTP 503 Service Unavailable
Retry-After: 30
Content-Type: application/problem+json
```

## Почему

Собственный заголовок не заменяет стандартную семантику.

## Когда применять

X-Request-Id полезен для поддержки, если согласован. X-App-Result, X-App-Action и X-App-Validate не обязательны для всех API. Content-Language указывают по смыслу представления.

## Как проверить

- Работает ли обычный HTTP-клиент без знания собственных заголовков?

## Человек

Согласует требования клиентов, прокси и трассировки.

## Агент

Реализует серверный контракт и проверяет успешный запрос, неверный ввод и повторное обращение.

Контроль результата:

- Работает ли обычный HTTP-клиент без знания собственных заголовков?

## Источники

- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110.html)

Уровень: Рекомендуется. Проверено: 2026-11-09. Изменено: 2026-11-09.

[Исходный файл](https://github.com/sergey-from-riders/vibecoding-base/blob/4880e8b4372c96001c2e052be28b68a95d31252b/registry/standards/api/openapi-modular/rules/headers.md)