在房源响应中,类别和属性字段以代码形式返回(例如 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,并缓存一天:获取一次后重复使用。代码可能随时间增加;如果缓存副本中缺少某个代码,请直接显示原始代码,不要报错。