В каком виде описывали API контракт? Из каких разделов состояла спецификация?

API контракт обычно описывают в формате OpenAPI (ранее Swagger), RAML или API Blueprint. Спецификация включает следующие основные разделы:

• Info — общая информация о API (название, версия, описание).
• Paths — описание эндпоинтов, включая методы (GET, POST и т.д.), параметры запроса, тело запроса и ответы.
• Components — схемы данных (модели), которые используются в запросах и ответах.
• Security — описание механизмов аутентификации и авторизации.
• Tags — группировка эндпоинтов по категориям.

Такой контракт позволяет четко определить, как клиент и сервер взаимодействуют, и служит документацией для разработчиков.