Hypermedia Api — представление данных раскрывающегося списка

Я создаю API-интерфейс гипермедиа, соответствующий спецификации HAL.

Когда пользователь отправляет платеж, ему необходимо указать, какой тип карты он использует (Visa, Master Card и т. д.).

Таким образом, для определенного поля, которое отправляется, существует определенный список значений, которые можно использовать.

Как представить этот список выбора пользователю?

Как встроенные данные?

Есть ли вообще способ связать поле с заданным набором данных?

Я понимаю, что спецификация HAL очень мала и конкретно не охватывает эту проблему. Но вообще гипермедиа-апис, как люди обычно представляют эти данные?

Или я должен просто объяснить поле в ссылке CURIE? спасибо


api rest hypermedia
person ChrisCa    schedule 03.03.2016    source источник
comment
Являются ли типы карт просто названиями? Как насчет простого списка названий типов карт?   -  person    schedule 03.03.2016
comment
да - это будет список строк. Мне просто интересно, как связать этот список с данным полем. так что вы знаете, что это поле может быть значением только из списка   -  person ChrisCa    schedule 03.03.2016

Ответы (1)


arrow_upward
0
arrow_downward

Вы правы, HAL специально не занимается этим вопросом. Вы можете решить эту проблему, по существу скопировав HTML. В HTML определены различные виджеты для представления вещей, например поле со списком с перечисленными параметрами.

Вы можете определить media-type с аналогичными элементами управления, а также можете определить модель обработки для media-type. Конечно, это может быть представление json, не обязательно должно быть xml.

Например

{
    ...
    "cardType": {
       "inputType": "select",
       "possibleValues": ["Visa", "MasterCard", ... ]
    }
    ...
}

Готового формата, о котором я знаю, к сожалению, нет.

person Robert Bräutigam    schedule 03.03.2016