eWوثائق eWasl

أدوات المُنشئ

توليد المحتوى بالذكاء الاصطناعي، وأدوات الاستوديو للصور، ومكتبة الوسائط، وصفحة الروابط — عبر الواجهة و MCP.

إلى جانب النشر والإعلانات، يعرض eWasl حقيبة أدوات المُنشئ عبر الواجهة و MCP: كاتب الذكاء الاصطناعي، وأدوات الاستوديو للصور، ومكتبة وسائطك، وصفحة الروابط (link-in-bio). كل منها محكوم بنطاق مفتاح API خاص به.

كاتب المحتوى بالذكاء الاصطناعي

POST/api/v1/content/generate
content:create

ولّد نصّاً واعياً بصوت العلامة التجارية. يعيد نصاً فقط — مرّر النتيجة إلى POST /posts للنشر. غير متدفّق (non-streaming).

promptstringRequired
ما المطلوب كتابته — مثل "٣ تعليقات إنستغرام لافتتاح مقهى". بحد أقصى 2000 حرف.
platformstringRequired
حسّن لمنصة: facebook instagram twitter linkedin tiktok youtube pinterest snapchat threads bluesky telegram.
tonestringRequired
professional · casual · engaging · humorous · inspirational (الافتراضي نبرة علامتك التجارية).
maxLengthintegerRequired
حدّ أحرف تقريبي (50–2000).
language'ar' | 'en'Required
لغة المخرجات. تُكتشف تلقائياً من النص إن أُغفلت.
contextstringRequired
سياق إضافي اختياري للكاتب.

Response Example

{ "data": { "text": "☕️ افتتاح جديد! تعالوا نحتفل …", "language": "ar" } }

أداة MCP: generate_content.

الاستوديو — أدوات الصور بالذكاء الاصطناعي

تأخذ كلتا الأداتين رابط صورة https عاماً (ليتمكّن الوكلاء غير المتصفّحين من استخدامها) وتعيدان روابط الصور المعالَجة. مدعومة بـ fal.ai، محكومة بالخطة، ومحدودة المعدل.

POST/api/v1/studio/bg-remove
studio

أزِل خلفية صورة ← PNG شفّاف.

imageUrlstringRequired
رابط https عام للصورة المصدر.

Response Example

{ "data": { "url": "https://fal.media/…/out.png", "contentType": "image/png", "width": 1024, "height": 1024 } }
POST/api/v1/studio/smart-resize
studio

تغيير حجم/اقتصاص واعٍ بالمحتوى إلى حجم واحد أو أكثر مع الحفاظ على الموضوع.

imageUrlstringRequired
رابط https عام للصورة المصدر.
targetSizesarrayRequired
من 1 إلى 4 من { width, height } (كل منها 32–4096 بكسل).

أدوات MCP: remove_background، smart_resize_image.

مكتبة الوسائط

GET/api/v1/media
media:read

اعرض أصولك المرفوعة، الأحدث أولاً. استخدم url المُعاد كمدخل وسائط لـ create_post أو أدوات الاستوديو. (يبقى الرفع داخل التطبيق.)

typestringRequired
تصفية: image · video · all.
searchstringRequired
تصفية باسم الملف.
limitintegerOptional
Default: 20
حجم الصفحة (1–100).
pageintegerOptional
Default: 1
رقم الصفحة.

أداة MCP: list_media.

GET/api/v1/links/bio
links:read
PATCH/api/v1/links/bio
links:write

اقرأ أو حدّث صفحة روابطك العامة. PATCH عملية upsert — أرسل الإعداد الكامل. يُتحقّق من اختطاف الـ slug ومن مضيف الصورة الرمزية على الخادم.

profileNamestringRequired
الاسم الظاهر.
biostringRequired
نبذة قصيرة.
linksarrayRequired
[{ id, title, url }].
layoutstringRequired
قالب التخطيط "0"–"5".
slugstringRequired
slug مخصّص للرابط.
avatarUrlstringRequired
رابط الصورة الرمزية (يجب أن يكون مضيف eWasl/Supabase مسموحاً).
themeConfigobjectRequired
{ bgColor, textColor, buttonColor, buttonTextColor, preset }.

أدوات MCP: get_link_in_bio، update_link_in_bio.

رموز الحالة

200 نجاح.
403 نطاق مفقود، أو لست على خطة Professional/Enterprise.
422 خطأ تحقّق.
502 خطأ من مزوّد الذكاء الاصطناعي / الصور — يمكن إعادة المحاولة بأمان.

في هذه الصفحة