Docs

字典

最后更新: 2026-10-02阅读约 2 分钟

在房源响应中,类别和属性字段以代码形式返回(例如 type: "Residential"、condition: "Cosmetic renovation"、utilitySystem: ["gas", "water"])。此接口把代码转换为 10 种支持语言中任意一种的可读标签。免费,任何密钥都可使用。

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

单一语言的标签

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

返回该语言下所有字典,展平为 { code: label }:

{
  "version": "sha256-...",
  "lang": "zh",
  "dictionaries": {
    "propertyType": { "Residential": "住宅", "Commercial": "商业", ... },
    "condition": { ... },
    "utilitySystem": { ... },
    ...
  },
  "requestId": "req_..."
}

支持的 lang:en、ru、uk、de、es、az、ar、fr、zh、tr。其他值返回 400。如果某个代码在所请求的语言中没有标签,则返回英文标签。

变体

  • 一次获取所有语言:省略 lang。每个代码附带 labels 对象:{ "value": "Residential", "labels": { "en": "Residential", "uk": "Житлова", ... } }。
  • 单个字典:加上 name,例如 GET /dictionaries?name=propertyType&lang=zh。未知名称返回 404。

可用字典

propertyType、residentialType、commercialType、industrialType、condition、utilitySystem、amenities、onsiteAmenities、apartType、apartmentType、status、objectType。

响应带有 version,并缓存一天:获取一次后重复使用。代码可能随时间增加;如果缓存副本中缺少某个代码,请直接显示原始代码,不要报错。

这篇文章对您有帮助吗?