超媒体 API - 呈现选项列表数据

Question

我正在创建一个符合 HAL 规范的超媒体 api

当用户提交付款时，他们需要指定他们使用的卡类型（Visa、万事达卡等）

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

如何向用户展示该选择列表？

作为嵌入数据？

是否有一种方法可以将字段与给定的数据集相关联？

我意识到 HAL 规范非常小，并没有专门涵盖这个问题。但是一般超媒体apis人们通常是如何呈现这些数据的呢？

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

Answer 1

你是对的，HAL 没有专门讨论这个问题。你可以通过复制HTML来解决这个问题。 HTML 中定义了不同的小部件来呈现内容，例如带有列出选项的组合框。

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

例如

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

不幸的是，我知道没有现成的格式。