Docs

词典

最后更新: 2026-07-24阅读约 2 分钟

房源接口返回的分类和属性字段是代码(例如 type: "Residential"condition: "Cosmetic renovation"utilitySystem: ["gas", "water"])。这个接口用于把这些代码转成可读标签,支持 8 种语言中的任意一种。

基础地址:https://developers.grem.capital/api/v1

获取某种语言的标签

GET /dictionaries?lang=en
Authorization: Bearer gsk_live_...

返回该语言下所有词典,形式为 { code: label }

{
  "version": "2026-07-24",
  "lang": "en",
  "dictionaries": {
    "propertyType": { "Residential": "Residential", "Commercial": "Commercial", ... },
    "condition": { "Cosmetic renovation": "Cosmetic renovation", ... },
    "utilitySystem": { ... },
    ...
  },
  "requestId": "req_..."
}

lang 支持的取值:enruukdeesazarfr

其他用法

  • 一次取回全部语言 — 不传 lang。此时每个代码都会带上完整的 labels 对象:{ "value": "Residential", "labels": { "en": "Residential", "ru": "Жилая", ... } }
  • 只取一个词典 — 加上 name,例如 GET /dictionaries?name=propertyType&lang=en。名称不存在时返回 404

可用的词典

propertyTyperesidentialTypecommercialTypeindustrialTypeconditionutilitySystemamenitiesonsiteAmenitiesapartTypeapartmentTypestatusobjectType

响应中带有 version,可缓存一天 — 取一次反复使用即可。代码会随时间增加,因此当您缓存的副本里没有某个代码时,请回退到原始代码,而不要直接报错。

这篇文章对您有帮助吗?