للمطورين

Use AI workflows as an API

ترايجر، تحقق النتائج، الاستجابة للموافقات، وجلب القطع الأثرية كل شيء على REST، مع لا مكالمات نموذجية، و retries، أو الاستفسارات للحفاظ على نفسك.

ابدأ بالمجان اقرأوا docs →

14 ف-16 نطاقات الإذنصندوق رمل 7 لغات

braidrun v1 APIREST · JSON

# يُجرّبُ تنفيذاً
POST /api/webhooks/{id}/trigger
→ {"executionId": "exec_51a2"}

# Poll status: this one paused at manual approval
GET  /api/v1/executions/exec_51a2
→ {"status": "AWAITING_APPROVAL"}

الاستمرار بعد الموافقة (يمكن تحرير القيمة قبل الموافقة)
POST /api/v1/approvals/{approvalId}/approve

# إحصل على النتيجة و القطع الأثرية ذات مرة
GET  /api/v1/executions/exec_51a2/result
GET  /api/v1/executions/exec_51a2/artifacts

مسار التكامل

15 دقيقة، من إنشاء وينهوك للحصول على النتيجة الأولى

وهناك أربعة من طلبات مبادرة " HTTP " تدير التدفق بكامله، ولا تحتاج إليها مؤسسة " SDK " ، وأي لغة يمكن أن تقدم الطلبات يمكن أن تتكامل.

01اصنعوا ويب هوك, واحصلوا على المفتاحأضفْ a ويب هوك الزناد إلى سيرِ عملِكَ في النقابةِ للحُصُول على a مخصّص URL؛ ثمّ يَجْعلُ a مفتاح API مَع النطاقِ WBHOOK TRIGGER.

WEBHOOK_TRIGGERX-API-Key

02POST واحد يُسبّبُ تنفيذاًوترسم خرائط ميدانية رفيعة المستوى للشبكة بشكل تلقائي لمتغيرات تدفق العمل من نفس الاسم، أو يمكنك رسم خريطة صريحة بمسح متغير؛ وتوضع الحمولة في 1MB.

POST≤ 1MB

03تُفسد حالة تنفيذ وتحصل على النتيجة(ج) استخدام طريقة التنفيذ المعادة للتحقق من تفاصيل التنفيذ؛ وفور الانتهاء من ذلك، الحصول على الناتج من نقطة النهاية، وتحميل الملفات من نقطة نهاية القطع الأثرية.

GET /api/v1/executions/{id}EXECUTION_READ

04الإجراءات التي تحتاج إلى استعراض بشري تمر من خلال الموافقةويتوقف التنفيذ في دليل - خطوة الموافقة؛ ويستخدم نقاط الموافقة النهائية لإدراج البنود المعلقة والموافقة عليها أو رفضها، ولا يغير أي شيء من الرفض أو الوقت.

APPROVAL_RESPONDالحق في الوقت المناسب

terminalX-API-Key · JSON ≤ 1MB

# الخطوة 2: إرسلْ a بيست مِنْ نظامِكَ
curl -X POST https://your-host/api/webhooks/{id}/trigger \
  -H "X-API-Key: <your-api-key>" \
  -d '{"ticket_id": "T-1024", "lang": "zh"}'
خريطة الحقول الرفيعة المستوى آليا لمتغيرات تدفق العمل لنفس الاسم
→ {"executionId": "exec_51a2"}

# الخطوة 3: حالة الاقتراع والحصول على النتيجة عندما تنتهي
curl https://your-host/api/v1/executions/exec_51a2/result \
  -H "X-API-Key: <your-api-key>"

قائمة القدرات

ستة أشياء يهتم بها المطورون

الخطوات الرمزية في 7 لغاتWrite in Python, JavaScript, TypeScript, Bash, Ruby, Lua, or the CLI; changes are injected as WF VAR * environment variables, the default timeout is 30 seconds, and in production it runs in a Docker Sandbox with controlled egress.

WF_VAR_*30s timeout

تعاريف (يام إل) التي تلائم سير العملتدفق العمل هو ملف واحد من طراز YAML: الالتزام، النشر، والتراجع كل شيء يحدث في repo كنت تعرف بالفعل؛.

workflow.yamlgit diff

MCP لربط أدواتك الخاصةاجمعي خدمة داخلية كخادمة مقطعية وألحقيها بوكيل، ويمكن لخطوات آي أن تتصل بنظامك مباشرة، دون انتظار منصة بناء موصل.

العملية التشاورية المتعددة الأطرافagent tools

مصحح نقاط التوقفتوقف 9 أنواع من نقاط التفتيش على ضربة حتى تتمكن من تحرير المتغيرات والاستمرار؛ وبعد الفشل، تعود من خطوة محددة، مع إكمال خطوات الإدارة غير القانونية غير الموثقة مرة أخرى.

9 breakpointsPro

14 نقطة ضد 1 API, least privilegeويتمتع كل من عمليات تنفيذ الثلاثية، والتحقق من النتائج، والرد على الموافقات، وتحميل القطع الأثرية بنطاق إذنه الخاص؛ ويجمع بين النطاقات الستة حسب الحاجة، ويصدر كل نظام متصل مفتاحه الخاص.

v16 scopes

الزناد المتناثرة بالقتلوبعد الانتهاء من عملية " باء " ، تحفز " باء " تلقائياً في وقت لاحق بثانية واحدة، مع حد أقصى " ماكسرونز " ؛ وتقسم عملية طويلة إلى أجزاء، كل منها مع سجلاتها الخاصة وتكاليفها.

DELAYED_COMPLETIONmaxRuns

الحدود الشرفية

ثلاثة أشياء قُلت في المقدمة

إذاً أنت لا تكتشف منتصف الطريق من خلال الاندماج.

لا المئات من الموصلاتوتذهب الدعوات إلى النظم الخارجية في خطوات رمزية، أو تغليفها كأدوات من برنامج المقارنات المتعددة الأطراف ملحقة بوكيل؛ وبالنسبة لفريق يكتب الرمز، فإن هذه الخطوة هي مجرد بضعة خطوط من طلبات شركة HTTP.

عدم وجود تقدير للتكلفة قبل التشغيلكل عملية تنفيذ و كلفة يتم تسجيلها في كل مرة، لذا المحاسبة بعد الفعل هي الصدرية، ولكن ليس هناك إقتباس قبل التشغيل، لذلك فإن مراقبة الميزانية تعتمد على بوابات الموافقة وماكسرونز.

Limits stated plainly upfrontويتم تجهيز حمولة " ويهوك " في 1MB؛ وتقصير الخطوات الرمزية إلى فترة انقطاع مدتها 30 ثانية؛ ولا يُحتفظ بالتوقيعات HMAC-SHA256 إلا كطريقة للتوافق، وتستعمل التكاملات الجديدة مفتاح " API " .

Docs

ثلاثة يستحقون القراءة قبل أن تدمج

GET /api/v1/*المرجع السابقحقول الطلب والرد ورموز الأخطاء لـ 14 نقطة نهاية، بالإضافة إلى كيفية تحديد نطاقات الإذن الستة.إفتحي الوثائق →POST /api/webhooks/*مشغل Webhook(ب) الحصول على نظام " أورل " و " مفتاح " ، وقواعد رسم خرائط متغيرة، وطريقة التوافق في " HMAC " ، و " 1MB " .إفتحي الوثائق →workflow.yamlYAML Syntax8 خطوات، بالإضافة إلى كيفية كتابة المُحدّدات مثل الحالة، الرجعية، والنسخ اليدوي.إفتحي الوثائق →

قم بتوصيل أول سير عملك إلى نظامك

الخطة الحرّة تسمح لك ببناء تدفق عمل وتديره يدوياً، ترقية إلى (برو) عندما تحتاج إلى (ويهوك).

ابدأ بالمجان اقرأوا docs