Docs

نظرة عامة على API

مقدمة عن واجهة برمجة التطبيقات في منصة مُلكم وكيفية استخدامها

منصة مُلكم توفر اكثر من 161 Edge Function تغطي جميع عمليات المنصة من الدفع والشحن الى الذكاء الاصطناعي والتواصل الاجتماعي.

Base URL

جميع الطلبات تُرسل الى:

https://[PROJECT_REF].supabase.co/functions/v1/

المصادقة

تستخدم جميع الـ APIs مصادقة Supabase JWT. ارسل الـ token في header كل طلب:

curl -X POST \
  https://[PROJECT_REF].supabase.co/functions/v1/[FUNCTION_NAME] \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

تصنيفات API

المدفوعات (Payments)

الوظيفةالوصف
create-tap-chargeانشاء عملية دفع جديدة
create-tap-charge-with-tokenدفع بالبطاقة المحفوظة
tap-webhookاستقبال اشعارات الدفع
create-subscription-chargeانشاء اشتراك جديد
create-subscription-charge-hostedاشتراك عبر صفحة Tap
subscription-tap-webhookاشعارات الاشتراك

الشحن (Shipping)

الوظيفةالوصف
oto-create-shipmentانشاء شحنة جديدة
oto-get-delivery-feesحساب تكلفة الشحن
oto-track-shipmentتتبع الشحنة
oto-webhookتحديثات حالة الشحن
test-oto-connectionاختبار اتصال OTO

الذكاء الاصطناعي (AI)

الوظيفةالوصف
analyze-productتحليل صورة منتج واستخراج البيانات
enhance-product-contentتحسين وصف المنتج بالـ AI
enhance-product-imageتحسين صورة المنتج
enhance-smart-product-imageتحسين ذكي لصور المنتجات
generate-logoانشاء شعار بالـ AI
generate-bannerانشاء بانر ترويجي
generate-iconانشاء ايقونة
generate-blog-articleكتابة مقال مدونة
generate-blog-autopilotنشر تلقائي للمدونة
generate-ad-contentانشاء محتوى اعلاني
generate-designتصميم صفحات بالـ AI
process-ai-productمعالجة منتج AI
process-smart-productمعالجة منتج ذكي

التواصل الاجتماعي (Social)

الوظيفةالوصف
publish-postنشر على فيسبوك/انستغرام
publish-x-postنشر على X (تويتر)
publish-tiktok-postنشر على تيك توك
publish-threads-postنشر على Threads
publish-youtube-videoنشر على يوتيوب
send-whatsapp-messageارسال رسالة واتساب
social-postsجلب المنشورات

الاشعارات (Notifications)

الوظيفةالوصف
send-emailارسال بريد الكتروني
send-push-notificationارسال اشعار push
send-browser-pushاشعار المتصفح
dispatch-notificationتوزيع الاشعارات

ادارة المنتجات

الوظيفةالوصف
prepare-importتحضير استيراد المنتجات
process-importمعالجة استيراد المنتجات
bulk-update-productsتحديث منتجات بالجملة
process-product-queueمعالجة طابور المنتجات
enrich-product-dataاثراء بيانات المنتج

الدومينات والنشر

الوظيفةالوصف
manage-custom-domainادارة الدومين المخصص
dns-lookupفحص DNS
resolve-domainحل الدومين
trigger-deployتفعيل النشر

اكواد الاستجابة

الكودالوصف
200نجاح
201تم الانشاء بنجاح
400طلب غير صالح -- تحقق من المعطيات
401غير مصرح -- JWT منتهي او غير صالح
402رصيد AI غير كافٍ
404المورد غير موجود
429تجاوز حد الطلبات
500خطأ داخلي في الخادم

معالجة الاخطاء

جميع الاخطاء تُرجع بالتنسيق التالي:

{
  "error": "وصف الخطأ باللغة الانجليزية"
}