房源接口返回的分类和属性字段是代码(例如 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 支持的取值:en、ru、uk、de、es、az、ar、fr。
其他用法
- 一次取回全部语言 — 不传
lang。此时每个代码都会带上完整的labels对象:{ "value": "Residential", "labels": { "en": "Residential", "ru": "Жилая", ... } }。 - 只取一个词典 — 加上
name,例如GET /dictionaries?name=propertyType&lang=en。名称不存在时返回404。
可用的词典
propertyType、residentialType、commercialType、industrialType、condition、utilitySystem、amenities、onsiteAmenities、apartType、apartmentType、status、objectType。
响应中带有 version,可缓存一天 — 取一次反复使用即可。代码会随时间增加,因此当您缓存的副本里没有某个代码时,请回退到原始代码,而不要直接报错。