# API Contract Rules

## Назначение

Этот файл описывает, как оформлять подраздел `## Контракт` в API-документах.

## Что должно быть описано

- входные параметры
- выходные параметры
- JSON-структуры запросов и ответов
- обязательность полей
- типы полей
- ограничения
- описание назначения полей
- примеры данных
- auth
- idempotency
- timeout
- ошибки и их HTTP-коды

## Правило качества

Контракт должен быть достаточно формальным, чтобы по нему можно было собрать OpenAPI-спецификацию.
