Docs

القواميس

آخر تحديث: 2026-10-022 دقيقة قراءة

في ردود العقارات تأتي حقول الفئات والسمات رموزا (مثلا type: "Residential"، condition: "Cosmetic renovation"، utilitySystem: ["gas", "water"]). تحوّل نقطة النهاية هذه الرموز إلى تسميات مقروءة بأي من اللغات العشر المدعومة. مجانية ومتاحة لأي مفتاح.

العنوان الأساسي: https://developers.grem.capital/api/v1.

تسميات للغة واحدة

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

تعيد كل القواميس مسطحة إلى { code: label } لتلك اللغة:

{
  "version": "sha256-...",
  "lang": "ar",
  "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=ar. الاسم غير المعروف: 404.

القواميس المتاحة

propertyType، residentialType، commercialType، industrialType، condition، utilitySystem، amenities، onsiteAmenities، apartType، apartmentType، status، objectType.

للرد قيمة version ويُحفظ مؤقتا يوما كاملا: نزّله مرة وأعد استخدامه. قد تُضاف رموز مع الوقت؛ فإذا غاب رمز عن نسختك المحفوظة فاعرض الرمز كما هو بدلا من الفشل.

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