YachtLuma
المطورون

توثيق API

استعلم عن الطرز والأحواض والأماكن والإعلانات المنشورة عبر REST أو MCP. عاين الاستجابة بلغتك قبل التكامل.

الموارد

طرازات اليخوت
GET /api/v1/models
أحواض البناء
GET /api/v1/builders
المراسي
GET /api/v1/marinas
معدات اليخت
GET /api/v1/equipment
رحلات تأجير اليخوت
GET /api/v1/departures
مقدمو الخدمات
GET /api/v1/providers
الوسائط المرخّصة
GET /api/v1/media
curl -sS 'https://yachtluma.ai/api/v1/models/lagoon-42?locale=ar'
curl -sS 'https://yachtluma.ai/api/v1/compare?models=lagoon-42,lagoon-46&locale=ar'

الترقيم والفلاتر

استخدم limit من ١ إلى ١٠٠ وoffset بدءاً من الصفر. مرّر nextOffset للصفحة التالية حتى يصبح null. رشّح الطرز بحسب builder أو type والإعلانات بحسب category.

curl -sS 'https://yachtluma.ai/api/v1/models?q=Lagoon&locale=ar&limit=2&offset=0'
curl -sS 'https://yachtluma.ai/api/v1/listings?category=charter&locale=ar&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/departures?mode=seat&guests=2&location=Palma&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/providers?service=maintenance&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/media?entityType=model&entityId=lagoon-46&locale=ar'

إتاحة الحقول

تتبع كل مواصفة إذن مصدرها للتوزيع على الويب وAPI والذكاء الاصطناعي. قد تكون مصفوفة المواصفات فارغة. احتفظ بالحالة والوحدة والتاريخ والتجهيز عند عرض قيمة.

specifications_status · available / not_available_for_this_channel

التطبيقات والحصص

تتشارك الطلبات المجهولة ١٠٠٠٠ طلب يومياً بتوقيت UTC. للتطبيق الموافق عليه حصة يومية مستقلة وقنوات وموارد معتمدة. أرسل مفتاحه في ترويسة Authorization.

Authorization: Bearer <APPLICATION_KEY>
تطبيقاتي

MCP

اربط عميل MCP بنقطة النهاية عبر Streamable HTTP. نفّذ initialize ثم tools/list للاطلاع على مخططات الأدوات الحالية. تقرأ الاستدعاءات السجلات المنشورة.

POST https://yachtluma.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_models",
    "arguments": {
      "q": "Lagoon",
      "locale": "ar",
      "limit": 3
    }
  }
}
  • search_models
  • search_builders
  • search_listings
  • find_marinas
  • search_equipment
  • search_knowledge
  • get_model
  • get_listing
  • get_equipment
  • get_care_guide
  • compare_models
  • search_yacht_pages
  • get_market_counts
  • search_departures
  • get_departure
  • search_providers
  • get_provider
  • search_media
  • get_media
  • estimate_charter_budget