توثيق الربط البرمجي المباشر لمحرك Adnove
قم بربط محرك الذكاء الاصطناعي للتسويق العقاري مباشرة مع بوابتك العقارية أو نظام إدارة علاقات العملاء (CRM) لتوليد وتحليل حملات الفيديو بدقة 720p HD Preview آلياً.
تم إلغاء مسارات /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).
→ البديل المعتمد: POST /api/v1/render-video
→ البديل المعتمد: GET /api/v1/jobs/{id}
تحليل العقار واستخراج الزوايا التسويقية
تحليل رابط العقار (مبوبة، ساروتي، أفيتو) أو الوصف الخام لاستخراج المزايا التنافسية، سعر المتر، شخصية المشتري المستهدف، والزوايا الإعلانية الأكثر إقناعاً.
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"}'{
"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"
}{
"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) | الوصف والإجراء المطلوب |
|---|---|---|
| 400 | BAD_REQUEST | بيانات الطلب غير صالحة أو المعلمات الإجبارية مفقودة. |
| 401 | UNAUTHORIZED | مفتاح الربط البرمجي مفقود أو غير صالح. ترويسة Authorization: Bearer مطلوبة. |
| 403 | INSUFFICIENT_SCOPE | محظور. مفاتيح المعاينة (Sandbox) مقيدة بنطاقات preview:read وpreview:dispatch ولا تملك صلاحية الوصول للفوترة أو بيانات المستأجرين والحسابات الأخرى. |
| 403 | QUOTA_EXCEEDED | تم استهلاك رصيد الباقة الشهري أو لا تملك الصلاحية للوصول لهذا المسار. |
| 429 | RATE_LIMIT_EXCEEDED | تم تجاوز الحد الأقصى لمعدل الطلبات في الدقيقة. |
| 500 | INTERNAL_SERVER_ERROR | حدث خطأ مؤقت في خوادم المعالجة السحابية. |
هل تحتاج ترخيصاً مؤسسياً أو ربطاً مخصصاً؟
تواصل مع فريق الهندسة البرمجية في Adnove لتفعيل حصص غير محدودة ودعم فني مخصص على مدار الساعة للوكالات الكبرى وبوابات العقارات.