REST API HATEOAS выпуск

Question

Я читаю о HATEOAS в ответе API, поэтому у меня есть этот случай, пользователь сначала нажмет на этот URL

1. /payment, этот URL вернет список разрешенных способов оплаты, и я думаю вернуть ключ ссылок, который содержит конечные точки этих разрешенных способов оплаты, но эти ссылки требуют, чтобы параметры были собраны / заполнены интегратором, не так ли? допустимо возвращать HATEOAS в этом случае, ссылки используют глагол GET.

Спасибо,

Answer 1

Допустимо ли возвращать HATEOAS в этом случае, ссылки используют глагол GET.

HATEOAS: ваш руководящий принцип "как бы я сделал это на веб-страницах?"

В вашем случае простая реализация может заключаться в том, что у вас есть страница / платежей и несколько ссылок (оплата через PayPal, оплата кредитной картой и т. Д.). Каждая из этих ссылок будет GET новая веб-страница, на которой была форма, показывающая потребителю, какая информация требуется для этого типа платежа. Эти формы могут немедленно отправлять платеж (который, вероятно, будет представлять собой POST с аргументами формы в теле контента), или они будут ссылаться на страницу подтверждения (GET, с аргументами формы, появляющимися в качестве параметров запроса), на которых будет отображаться Пользователь с кратким описанием платежа, с кнопкой подтверждения, которая будет делать POST, как и раньше.

Создание REST API с помощью HATEOAS - это то же самое, предназначенное для программы, а не для пользователя. Таким образом, ваш ключ ссылки будет содержать конечные точки для форм разрешенных способов оплаты, и эти формы будут отображаться с ключом ссылки, который соединяет форму с методами оплаты.