المواصفات الرسمية للواجهة البرمجية Adnove API v1.0.0 • ملف OpenAPI 3.1 موحد

توثيق الربط البرمجي المباشر لمحرك Adnove

قم بربط محرك الذكاء الاصطناعي للتسويق العقاري مباشرة مع بوابتك العقارية أو نظام إدارة علاقات العملاء (CRM) لتوليد وتحليل حملات الفيديو بدقة 720p HD Preview آلياً.

تحميل ملف OpenAPI 3.1 JSONEnglish Documentation
إشعار تقاعد وإلغاء مسارات العقد القديم (v0.9 API Deprecation)تاريخ التقاعد: 2026-10-01

تم إلغاء مسارات /api/v1/campaigns/generate و /api/v1/tasks/{id} وهي تعيد الآن رسمياً HTTP 410 Gone. تم توحيد كافة عمليات الرندر والاستعلام تحت POST /api/v1/render-video و GET /api/v1/jobs/{job_id}.

المصادقة والترخيص البرمجي

مرر مفتاحك السري المشفر عبر الترويسة القياسية Authorization: Bearer <key>.

معدل وسرعة معالجة الطلبات

حتى 60 طلب تحليل في الدقيقة و 30 وظيفة رندر متزامنة في وضع Preview مع عزل كامل لكل job_id.

دقة الفيديو والمخرجات

مخرجات رندر حقيقية بدقة 720p HD (أبعاد 1280×720، 60fps، وتردد صوت AAC 160kbps).

المسارات الرسمية المعتمدة (v1.0.0)
مسارات ملغاة (HTTP 410 Gone)
POST /api/v1/campaigns/generate410 GONE

→ البديل المعتمد: POST /api/v1/render-video

GET /api/v1/tasks/{id}410 GONE

→ البديل المعتمد: GET /api/v1/jobs/{id}

POST/api/v1/analyzeيتطلب مفتاح مصادقة

تحليل العقار واستخراج الزوايا التسويقية

تحليل رابط العقار (مبوبة، ساروتي، أفيتو) أو الوصف الخام لاستخراج المزايا التنافسية، سعر المتر، شخصية المشتري المستهدف، والزوايا الإعلانية الأكثر إقناعاً.

curl -X POST "https://adnove.com/api/v1/analyze" \
  -H "Authorization: Bearer YOUR_ADNOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://mubawab.ma/listing/1234","language":"darija"}'
نموذج الطلب والبيانات المرسلة (Request Body)
{
  "url": "https://mubawab.ma/listing/villa-luxury-marrakech-1234",
  "description": "Luxury 5-bedroom villa for sale in Marrakech Palmeraie, private pool and lush tropical garden.",
  "language": "darija",
  "target_audience": "investor"
}
نموذج الاستجابة الناجحة (Success Response - 200 OK)
{
  "ok": true,
  "status": "success",
  "property": {
    "title": "Luxury Villa Marrakech Palmeraie",
    "city": "Marrakech",
    "district": "Palmeraie",
    "price_mad": 4500000,
    "currency": "MAD",
    "features": [
      "5 Master Suites",
      "Private Infinity Pool",
      "Solar Heating",
      "Gated Security"
    ],
    "marketing_angles": [
      "High-yield tourism investment opportunity exceeding 9% annual ROI",
      "Tranquility and prestige of Palmeraie minutes from downtown Marrakech"
    ]
  }
}

جدول رموز الاستجابة والأخطاء القياسية لهذا المسار

رمز الحالةرمز الخطأ (Code)الوصف والإجراء المطلوب
400BAD_REQUESTبيانات الطلب غير صالحة أو المعلمات الإجبارية مفقودة.
401UNAUTHORIZEDمفتاح الربط البرمجي مفقود أو غير صالح. ترويسة Authorization: Bearer مطلوبة.
403INSUFFICIENT_SCOPEمحظور. مفاتيح المعاينة (Sandbox) مقيدة بنطاقات preview:read وpreview:dispatch ولا تملك صلاحية الوصول للفوترة أو بيانات المستأجرين والحسابات الأخرى.
403QUOTA_EXCEEDEDتم استهلاك رصيد الباقة الشهري أو لا تملك الصلاحية للوصول لهذا المسار.
429RATE_LIMIT_EXCEEDEDتم تجاوز الحد الأقصى لمعدل الطلبات في الدقيقة.
500INTERNAL_SERVER_ERRORحدث خطأ مؤقت في خوادم المعالجة السحابية.

هل تحتاج ترخيصاً مؤسسياً أو ربطاً مخصصاً؟

تواصل مع فريق الهندسة البرمجية في Adnove لتفعيل حصص غير محدودة ودعم فني مخصص على مدار الساعة للوكالات الكبرى وبوابات العقارات.