توثيق API برومبتاتي
تولِّد اختصار المقارنات والبرومبتات والمقالات والتصنيفات، وتُترجم المحتوى، وتصدّر قاعدة البيانات — كل ذلك من برنامجك أو سكربتك أو أداة العمل الخارجية عبر طلبات HTTP بسيطة بمفتاح API.
الوصول عبر مفتاح API واحد
كل نقطة نهاية تتطلب المصادقة. أرسل مفتاحك في ترويسة Authorization: Bearer <KEY> أو x-admin-token: <KEY>. المفتاح متاح في لوحة التحكم ← تبويب «واجهة API الخارجية». عند توليد مفتاح جديد يُلغى القديم فوراً.
Authorization: Bearer ph_api_abc123... # أو x-admin-token: ph_api_abc123...
نقاط النهاية (Endpoints)
/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}'
/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}'
/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}'
/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}'
/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"}'
/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" \
/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.
- هذه الواجهة خاصة ومخصصة لاستخدامك أنت وبرامجك — لا تشارك المفتاح علناً.