في ردود العقارات تأتي حقول الفئات والسمات رموزا (مثلا 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 ويُحفظ مؤقتا يوما كاملا: نزّله مرة وأعد استخدامه. قد تُضاف رموز مع الوقت؛ فإذا غاب رمز عن نسختك المحفوظة فاعرض الرمز كما هو بدلا من الفشل.