Написание спецификации к REST api

Виктор8 лет в сервисе
Данные заказчика будут вам доступны после подачи заявки
23.05.2017

Нужно написать рекомендации доработке существующего API, прошу отклинуться людей работавших в данном направлении