API - это прикладное программирование интерфейс . Другими словами, объектные структуры возвращают функцию так же, как и интерфейс на основе кода. Таким образом, вы можете и должны иметь класс в клиентском приложении, который «реализует» интерфейс, давая вам что-то для привязки данных.
С точки зрения API, просто как основанный на коде интерфейс не должен изменяться после публикации, а также структура данных, возвращаемая API. Если требуются изменения, необходимо опубликовать новую версию, а затем всем клиентам должно быть дано предупреждение об устаревании и предложено обновить свой код, чтобы учесть эти изменения до того, как фактически вступят в силу. Затем вы, как потребитель API, просто измените свой класс в соответствии с новой версией.
Длинно и коротко, просто создайте класс для представления данных и десериализации в них. Вот как это работает, и в этом нет ничего плохого.