عقد سير العمل والتكاملات
كل endpoint تبنيه في بنّاء الـ API هو سير عمل مكوّن من عقد. يشحن المحرك 40 عقدة نشطة منظّمة حسب الفئة — من المحفّزات والوصول إلى قاعدة البيانات إلى الذكاء الاصطناعي والمدفوعات ونحو 24 تكاملاً مع أطراف ثالثة. اسحبها إلى اللوحة البصرية، أو اطلب من الذكاء الاصطناعي ربطها لك.
عقدة postgresql معطّلة
استخدم عقدة dypai_database المضمّنة لقراءة قاعدة بيانات مشروعك والكتابة إليها — لا حاجة لسلسلة اتصال. عقدة postgresql المستقلة معطّلة حالياً.
المحفّزات
المحفّز هو نقطة دخول endpoint. هناك أربعة أنواع محفّزات — تستخدم معظم endpoints محفّز HTTP API (لا عقدة مطلوبة؛ هو الافتراضي).
| المحفّز | العقدة | متى يعمل |
|---|---|---|
| HTTP API | (لا شيء — الافتراضي) | عندما يستدعي تطبيقك /api/v0/{name} |
| Webhook | webhook_trigger | عندما يرسل خدمة خارجية POST إلى عنوان URL لـ webhook |
| Schedule | schedule_trigger | على جدول cron |
| Telegram | telegram_trigger | عند رسالة Telegram واردة |
| Twilio | twilio_trigger | عند حدث SMS/صوت وارد من Twilio |
الذكاء الاصطناعي
| العقدة | ما تفعله | بيانات الاعتماد |
|---|---|---|
agent | يشغّل وكيل ذكاء اصطناعي (DYPAI Managed أو BYOK)، يمكنه استدعاء endpoints أدواتك | اختياري — لا شيء لـ المدار، أو OpenAI/Anthropic/Gemini لـ BYOK |
image_generation | يولّد صوراً، مدار فقط، يُرجع عنوان URL للتخزين | لا شيء (يُفوتر كأرصدة ذكاء اصطناعي) |
استخدام الذكاء الاصطناعي يُقاس كأرصدة ذكاء اصطناعي
عقدة agent في وضع DYPAI Managed وعقدة image_generation تستهلكان أرصدة الذكاء الاصطناعي. مع BYOK تدفع لمزوّدك مباشرة بدلاً من ذلك.
قاعدة البيانات والتخزين والمصادقة
| العقدة | ما تفعله |
|---|---|
dypai_database | الاستعلام عن الصفوف وإدراجها وتحديثها وحذفها في قاعدة بيانات مشروعك |
dypai_storage | رفع الملفات وتنزيلها وإدارتها في حاوياتك |
dypai_auth | عمليات المصادقة من جانب الخادم (إنشاء مستخدمين والتحقق من الرموز وغيرها) |
المدفوعات
| العقدة | ما تفعله | بيانات الاعتماد |
|---|---|---|
stripe | الرسوم والعملاء والاشتراكات والمزيد | Stripe (+ Stripe Webhook) |
polar | إدارة الفوترة والاشتراك | Polar (+ Polar Webhook) |
التواصل
| العقدة | ما تفعله | بيانات الاعتماد |
|---|---|---|
telegram | إرسال رسائل Telegram | Telegram |
whatsapp | إرسال رسائل WhatsApp | |
slack | النشر في قنوات Slack | Slack |
discord | النشر في Discord | Discord |
twilio | إرسال SMS / صوت | Twilio |
resend | إرسال بريد معاملات | Resend |
sendgrid | إرسال بريد معاملات | SendGrid |
email_smtp | إرسال بريد عبر SMTP | SMTP |
email_imap | قراءة بريد عبر IMAP | IMAP |
dypai_mail | بريد مدار — إرسال دون إعداد | لا شيء |
الإنتاجية و CRM والتجارة الإلكترونية
| العقدة | ما تفعله | بيانات الاعتماد |
|---|---|---|
google_sheets | قراءة/كتابة Google Sheets | Google Sheets |
airtable | قراءة/كتابة قواعد Airtable | Airtable |
notion | قراءة/كتابة صفحات Notion وقواعد البيانات | Notion |
trello | إدارة بطاقات Trello ولوحاته | Trello |
github | المستودعات والمسائل وطلبات السحب | GitHub |
linear | المسائل والمشاريع | Linear |
calendly | الجدولة والأحداث | Calendly |
hubspot | جهات اتصال CRM والصفقات | HubSpot |
shopify | المنتجات والطلبات | Shopify |
المنطق والبيانات والنواة
تشكّل هذه العقد البيانات وتوجّهها — لا بيانات اعتماد مطلوبة.
| العقدة | ما تفعله |
|---|---|
logic | تفرع شرطي (if / else) |
filter | الإبقاء على العناصر أو إسقاطها بشرط |
merge | دمج مدخلات متعددة في واحد |
foreach | التكرار على قائمة |
set_fields | بناء كائن أو إعادة تشكيله |
crypto | مساعدات التجزئة والترميز |
wait_delay | إيقاف سير العمل مؤقتاً لمدة محددة |
datetime | تنسيق التواريخ/الأوقات والتلاعب بها |
طلب HTTP والكود
| العقدة | ما تفعله | بيانات الاعتماد |
|---|---|---|
http_request | استدعاء أي REST API لا تغطيه عقدة مخصصة | HTTP Request (اختياري) |
javascript_code | تشغيل JavaScript مخصص مع env_vars نص عادي (ctx.env) | لا شيء |
عقدة Code لا تستطيع استخدام Credentials مكتوبة الأنواع
تقرأ عقدة javascript_code فقط env_vars النص العادي الخاصة بها المكشوفة كـ ctx.env.* — لا يمكنها اختيار بيانات اعتماد مكتوبة الأنواع وليس لديها ctx.secrets. لأسرار وقت التشغيل، استخدم أسرار الخلفية؛ لمفاتيح مزوّدي الأطراف الثالثة، استخدم بيانات الاعتماد على عقد التكامل المخصصة.
أي عقد تحتاج بيانات اعتماد؟
أي عقدة تتحدث إلى خدمة طرف ثالث تطلب بيانات اعتماد مكتوبة الأنواع مطابقة — تشحن DYPAI 26 نوع بيانات اعتماد إضافة إلى نوع مفتاح-قيمة Custom عام. خزّنها مرة في قسم بيانات الاعتماد، ثم اخترها على العقدة. لا تحتاج عقد المنطق والبيانات والنواة وعقد dypai_* أي بيانات اعتماد.