للأدوات ووكلاء الذكاء الاصطناعي: هذه الصفحة بصيغة Markdown · ملف OpenAPI العام
الوصف
دون nodeType تعرض كل أنواع الخطوات. لكل نوع label وdescription وcategory والإعدادات التي يقرؤها (configKeys) والحقول التي يخرجها للإشارة إليها بـ {{nodeId.field}} (outputFields) والباقة التي تشمله (requiredPlan) وهل تشمله باقة مساحة عملك (includedInPlan).
الصلاحية
تحتاج إلى مفتاح API أو اتصال OAuth يحمل صلاحية build.
المدخلات
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
nodeType | string | لا | أعد تفاصيل نوع الخطوة هذا وحده. |
ما تعيده
القائمة تعيد count وnodeTypes وplanTier (باقة مساحة عملك). والنوع الواحد يعيد بياناته مع note.
فحص الباقة
لكل نوع خطوة باقة. الإنشاء أو التعديل الذي يضيف خطوة لا تشملها باقة مساحة عملك يُرفض قبل حفظ أي شيء، مع code: "PLAN_REQUIRED" والباقة المطلوبة (requiredPlan) والخطوات المعنية (steps) والرسالة بالإنجليزية والعربية والصينية (messages). وتوضح exo_get_node_types الخطوات التي تشملها باقتك، وتذكرها exo_validate_flow كتحذيرات.
{
"saved": false,
"code": "PLAN_REQUIRED",
"upgradeRequired": true,
"currentPlan": "starter",
"requiredPlan": "pro",
"steps": [
{
"nodeId": "sftp_1",
"type": "sftp",
"label": "SFTP / FTP Files",
"family": "advanced_integrations",
"requiredPlan": "pro"
}
],
"messages": {
"en": "Your Starter plan doesn't include these steps: SFTP / FTP Files. They are part of the Professional plan. Nothing was created. Upgrade to Professional, or use steps your plan includes.",
"ar": "…",
"zh": "…"
}
}الأخطاء
تُعاد كنتيجة عادية مع isError: true:
Unknown node type "<nodeType>".
تُعاد كخطأ JSON-RPC:
| الرمز | HTTP | الرسالة |
|---|---|---|
| -32001 | 403 | API key lacks the 'build' permission required for flow authoring tools |
تظهر الرسائل كما يرسلها الخادم تماماً، بالإنجليزية. القيمة بين علامتي < > تُملأ وقت التشغيل.
أمثلة
مثال على الاستدعاء
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "exo_get_node_types",
"arguments": {
"nodeType": "http_request"
}
}
}curl -X POST https://exomations.com/api/mcp \
-H "X-Api-Key: exo_your_key" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"exo_get_node_types","arguments":{"nodeType":"http_request"}}}'مثال على النتيجة
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "Node type \"http_request\".\n{ ... }"
}
],
"structuredContent": {
"type": "http_request",
"label": "HTTP Request",
"description": "Make a basic HTTP request",
"category": "action",
"requiredPlan": "starter",
"includedInPlan": true,
"configKeys": [
"..."
],
"outputFields": [
"..."
],
"note": "..."
},
"isError": false
}
}قيم للتوضيح. في content يحمل النص بعد سطر الملخص البيانات نفسها التي في structuredContent.