API 文档中， Map 数据类型该如何描述？

[fuxkcsdn]

对于下面的 json

{
  "goods": [
    {
      "id": 123,
      "qty": 3
    },
    {
      "id": 321,
      "qty": 4
    }
  ]
}

如果想转换成如下的结构

{
  "goods": {
    "123": 3,
    "321": 4
  }
}

那文档里该如何描述 map.key 呢？

对于这 2 种数据结构，各位推荐用哪种？

[killpanda]

第一种，静态语言好解析，而且每个 item 其实都表示一个固定的资源