Имена путей к методам REST API в Micro Service

Question

Существует услуга, которая будет предоставлять функции регистрации для обслуживания клиентов. Один из методов предоставит список всех приложений, представленных пользователем. Из приведенных ниже вариантов значение должно ИЛИ будет лучше uri / путь для такого метода, основанного на принципах REST и Microservices.

1. / users / { id} / enrollments
2. / users / {id} / enrollments / list
3. / api / enrollments / submitter-id / {id}
4. / enrollments / {id} / list

Answer 1

Чтобы ответить на этот вопрос, может потребоваться немного больше информации, например, обзор архитектуры очень высокого уровня, который скажет, какие ресурсы вы определили для вашей системы. Теперь базовое c понимание, лежащее в основе формирования URL, формирует его вокруг ресурса https://en.wikipedia.org/wiki/Resource-oriented_architecture.

Например: скажем, вы создаете перезаписывающий API, где пользователь пытается записаться на курс. Здесь ресурсы могут быть как курс, топи c, урок и c. Теперь, чтобы получить список предоставленных тем, URL может выглядеть так:

GET /topics -> gets all the topics.
GET /topics/{id} -> gets specific topic.
POST /topics -> creates new topic.
PUT /topic/{id} -> updates a particular topic.

Надеюсь, это поможет вам