Docs

القواميس

آخر تحديث: 2026-07-241 دقيقة قراءة

تعيد ردود العقارات حقول الفئات والخصائص بوصفها رموزا (مثل 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 ويمكن تخزينه مؤقتا يوما كاملا - اجلبه مرة وأعد استخدامه. وقد تضاف رموز جديدة مع الوقت، فإن غاب رمز عن نسختك المخزنة فاستخدم الرمز الخام بدل الإخفاق.

هل كانت هذه المقالة مفيدة؟