واجهة برمجة التطبيقات

توثيق API برومبتاتي

تولِّد اختصار المقارنات والبرومبتات والمقالات والتصنيفات، وتُترجم المحتوى، وتصدّر قاعدة البيانات — كل ذلك من برنامجك أو سكربتك أو أداة العمل الخارجية عبر طلبات HTTP بسيطة بمفتاح API.

https://live-stream-sport.com
المصادقة (Authentication)

الوصول عبر مفتاح API واحد

كل نقطة نهاية تتطلب المصادقة. أرسل مفتاحك في ترويسة Authorization: Bearer <KEY> أو x-admin-token: <KEY>. المفتاح متاح في لوحة التحكم ← تبويب «واجهة API الخارجية». عند توليد مفتاح جديد يُلغى القديم فوراً.

Authorization: Bearer ph_api_abc123...
# أو
x-admin-token: ph_api_abc123...

نقاط النهاية (Endpoints)

POST/api/admin/generate-shortcutsيتطلب مفتاح API

توليد أوامر اختصار (Slash Commands)

توليد أوامر اختصار جديدة اختيارياً وفق توجيهاتك (أفكار / قسم / كلمة دليلية).

  • count: عدد الأوامر (1–20)
  • autoSave: الحفظ المباشر مع فتح الصفحة
  • model اختياري
curl -X POST "https://live-stream-sport.com/api/admin/generate-shortcuts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":5,"adminIdea":"أفكارك الاختيارية","category":"التسويق","keyword":"السيو","model":"gemini-3.8-flash","autoSave":true}'
POST/api/admin/generate-promptsيتطلب مفتاح API

توليد برومبتات ذكية

توليد برومبتات لأي قسم مع أفكارك أو ملاحظات إضافية.

  • categorySlug: معرّف القسم المطلوب
  • count: عدد البرومبتات
  • autoSave: الحفظ المباشر
curl -X POST "https://live-stream-sport.com/api/admin/generate-prompts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"categorySlug":"marketing","count":5,"adminIdea":"أفكارك الاختيارية","customNotes":"ملاحظاتك","autoSave":true}'
POST/api/admin/generate-categoryيتطلب مفتاح API

توليد أقسام / تصنيفات

توليد تصنيفات جديدة كلياً حسب الملاحظات أو تلقائياً.

  • count: عدد التصنيفات
curl -X POST "https://live-stream-sport.com/api/admin/generate-category" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":3,"adminNote":"ملاحظات اختيارية","autoSave":true}'
POST/api/admin/generate-articlesيتطلب مفتاح API

توليد مقالات المدونة

توليد مقالات كاملة وجاهزة (فقرات، قوائم، لوامع، قسم آي) مع حفظها في المدونة فوراً.

  • count: عدد المقالات (1–6)
  • topic/category/keyword: توجيه اختياري
  • تُحفظ تلقائياً وتظهر في /blog وsitemap
curl -X POST "https://live-stream-sport.com/api/admin/generate-articles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":2,"topic":"نسخ كتابة تسويقية","category":"التسويق","keyword":"محتوى","autoSave":true}'
POST/api/admin/translate-promptيتطلب مفتاح API

ترجمة برومبت إلى الإنجليزية

ترجمة برومبت موجود إلى النص الإنجليزي لتُعرض على الزوار الداعمين للنسخ الإنجليزية.

  • id: معرّف البرومبت (يظهر في الرابط أو عناوين JSON)
curl -X POST "https://live-stream-sport.com/api/admin/translate-prompt" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"PROMPT_ID"}'
GET/api/admin/api-keyيتطلب مفتاح API

عرض / تجديد مفتاح API

قراءة المفتاح الحالي (GET) أو توليد مفتاح جديد يُلغي القديم (POST).

  • POST يجدد المفتاح؛ يلزم استدعاؤه فقط من لوحة مشرف موثوقة
curl -X GET "https://live-stream-sport.com/api/admin/api-key" \
  -H "Authorization: Bearer YOUR_API_KEY" \
GET/api/admin/exportيتطلب مفتاح API

تصدير كامل البيانات

تنزيل نسخة JSON كاملة من المخزن (التصنيفات، البرومبتات، الأوامر، المقالات).

  • يُرجع ملف JSON كامل الحالة
curl -X GET "https://live-stream-sport.com/api/admin/export" \
  -H "Authorization: Bearer YOUR_API_KEY" \

ملاحظات عامة

  • جميع الردود تُرجع JSON؛ اقرأ حقل success ثم البيانات.
  • عند autoSave: true تُحفظ النتائج في قاعدة البيانات وتظهر في الموقع مباشرة.
  • طلب بدون مفتاح صحيح يُرجع 401 Unauthorized.
  • المقالات المولّدة تُضاف تلقائياً إلى /blog وخريطة الموقع sitemap.xml.
  • هذه الواجهة خاصة ومخصصة لاستخدامك أنت وبرامجك — لا تشارك المفتاح علناً.