Если еще актуально:
1. Проектирование нового SOAP сервиса и SOAP API
2. Проектирование нового REST сервиса и REST API
SOAP и REST API проектируются совершенно по разному.
Если по SOAP это спецификация (стиль RPC), то REST всего лишь "архитектурный стиль" аля для всего CRUD, все, что сложней какждый реализует, как может (это уже не REST).
REST API - это больше Public API, чтобы любой monkey coder, на любом языке смог его использовать без проблем, в этом вся фишка.
После того как прочитаете основы про REST, посмотрите примеры реализации
К примеру:
https://developer.paypal.com/docs/api/overview/советую почитать sql.ru:
http://www.sql.ru/forum/1294087/rest-a-kak-realizuutsya-metody-s-logikoy-slozhnee-chem-dobavit-udalitИ не используйте REST "внутри", зайдете на github на страничку генератора кода из контракта и посмотрите на issue, некоторые по несколько лет не исправляются ..... костылей и подпорок море - это Open Source - халявы там нет.
Если любите json, то посмотрите к примеру на Google gRPC/Protobuf vs JSON+HTTP; FaceBook Apache Thrift; GraphQL
Все это нужно рассматривать с "Тим. лидом" разработки и архитектором.
К примеру хайповый GraphQL patented facebook:
https://github.com/facebook/graphql/issues/351