Hypermedia Api - 呈现选项列表数据

时间:2016-03-03 14:56:45

标签: api rest hypermedia

我正在创建符合HAL规范的超媒体API

当用户提交付款时,他们需要指定他们使用的卡类型(Visa,Master Card等)

因此,对于提交的特定字段,可以使用特定的值列表

如何向用户提供该选择列表?

作为嵌入数据?

通常有一种方法可以将字段与给定的数据集相关联吗?

我意识到HAL规格非常小,并没有特别涵盖这个问题。但一般来说,超媒体apis人们通常如何呈现这些数据?

或者我应该简单地解释CURIE链接中的字段? 感谢

1 个答案:

答案 0 :(得分:0)

你是对的,HAL没有具体涉及这个问题。你可以通过基本上复制HTML来解决这个问题。 HTML中定义了不同的小部件来呈现内容,例如带有列出选项的组合框。

您可以定义其中包含类似控件的media-type,您也可以定义media-type的处理模型。它当然可以是json表示,不一定是xml

例如

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

不幸的是,我没有现成的格式。