تعيد ردود العقارات حقول الفئات والخصائص بوصفها رموزا (مثل type: "Residential" وcondition: "Cosmetic renovation" وutilitySystem: ["gas", "water"]). وتحول نقطة النهاية هذه تلك الرموز إلى تسميات مقروءة بأي من اللغات الثماني المدعومة.
العنوان الأساسي: 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 ويمكن تخزينه مؤقتا يوما كاملا - اجلبه مرة وأعد استخدامه. وقد تضاف رموز جديدة مع الوقت، فإن غاب رمز عن نسختك المخزنة فاستخدم الرمز الخام بدل الإخفاق.