Powerduck logo Powerduck

بيئة OpenAPI مدعومة بالذكاء الاصطناعي، والعمل المحلي أولاً

واجهة API الخاصة بك، من التطوير المحلي
إلى التوثيق والذكاء الاصطناعي.

وجّه Codex وClaude Code وCursor لكتابة الكود وفق تعريفات API. أنشئ التوثيق من الكود ونسّق الاختبارات بالذكاء الاصطناعي في تطبيق Powerduck لسطح المكتب، مع أولوية للعمل محليًا. واستضف توثيق OpenAPI وخوادم MCP مجانًا على Hub.

تنزيل تطبيق سطح المكتبانشر مجانًا على Hub
commerce-api/openapi.yaml OpenAPI 3.1 · ملف محلي
عقد OpenAPI واحد 
/orders
  post  createOrder
  get   listOrders
/products
  get   listProducts
/customers
  get   listCustomers
تم تحويله إلى خادم MCP قابل للتشغيل · 12 أداة قابلة للاستدعاء
وكيل البرمجة الخاص بك Cursor · Claude Code · Codex
powerduck · MCP server
powerduck.read_spec() تم العثور على 12 عملية
powerduck.start_mock("POST /orders") خادم المحاكاة يعمل على المنفذ 4010
powerduck.generate_tests("POST /orders") تم إنشاء orders.test.js
powerduck.call_api("POST /orders", {total:49}) 200 OK · تم التحقق وفق العقد
powerduck.publish_docs() تم تحديث التوثيق المرجعي
يتحول ملف OpenAPI واحد إلى أدوات يستدعيها وكيلك: المحاكاة والاختبارات واستدعاءات API والتوثيق، وكلها تُفحص وفق العقد نفسه.

العمل المحلي لا يحتاج إلى حساب. يستخدم الذكاء الاصطناعي البعيد خدمة النموذج التي تختارها؛ وتتطلب الاستضافة عبر الإنترنت حساب Cloud.

محرر المواصفات · تصحيح API · الاختبار · المحاكاة · توثيق API · خادم MCP

POWERDUCK HUB

مواصفة OpenAPI واحدة. طوّر محليًا وشارك عبر الإنترنت.

واصل العمل على API في تطبيق سطح المكتب. استخدم Hub لمشاركة التوثيق وربط أدوات الذكاء الاصطناعي بواجهتك.

  1. 01

    طوّر وتحقق

    صمّم API وصحح أخطاءها واختبرها في Powerduck.

  2. 02

    انشر من OpenAPI

    حوّل مواصفتك إلى توثيق مستضاف ونقطة اتصال MCP.

  3. 03

    شارك واربط

    شارك رابط التوثيق واربط عميل MCP، واختر ما إذا كنت تريد إدراج مشروعك للعامة.

انشر مجانًا على Hubاستكشف Hub

استضافة مجانية ضمن حدود الخطة. تواصل واجهة API الخاصة بأعمالك العمل على خادمك الخلفي.

لماذا Powerduck

ملف محلي واحد بدلاً من أدوات API المتفرقة.

يقود ملف OpenAPI YAML واحد في مستودعك التصميم وتصحيح الأخطاء والاختبار والمحاكاة والتوثيق وMCP. ويستخدم وكلاء البرمجة الملف نفسه.

ملف واحد لكل الإمكانات

صمّم وصحح واختبر وحاكِ ووثّق وقدّم MCP من مواصفة OpenAPI نفسها، لتبقى كل الأجزاء متوافقة.

طرق أخرى ملفات منفصلة للمجموعات والتوثيق والمحاكاة والاختبارات
Powerduck ملف YAML واحد لكل الأدوات والوكلاء

كل استجابة تُفحص وفق العقد

لا تُعرض الاستجابات فقط، بل تُفحص وفق مواصفة OpenAPI لالتقاط النوع أو المسار الخاطئ فورًا.

طرق أخرى إرسال الطلب وعرض الاستجابة 200
Powerduck إظهار الاختلاف عن المواصفة فور وصول الاستجابة

محلي أولاً، دون حساب، وجاهز للوكلاء

تبقى الملفات على جهازك وتعمل دون حساب أو رفع. يقرأ Codex وClaude Code وCursor المواصفة نفسها التي تقرؤها.

طرق أخرى حساب سحابي ورفع ملفات قبل البدء
Powerduck تشغيل محلي؛ ووكلاؤك يقرؤون الملف نفسه
~/commerce-api/openapi.yaml OpenAPI 3.1.0 3 مشكلات غير محفوظ
142 /users/{id}:
143 get:
144 operationId: getUser
145 summary: Retrieve a user
146 tags: [Users]
147 parameters:
148 - $ref: '#/components/parameters/UserId'
149 responses:
150 '200':
151 description: The requested user
152 content:
153 application/json:
154 schema:
155 $ref: '#/components/schemas/User'
156 '404': # description is required
157 contents:
158 application/json:
159 schema:
160 $ref: '#/components/schemas/Erorr'
161 delete:
162 summary: Delete a user
المشكلات خطآن · تحذير واحد تم التحقق وفق لهجة 3.1
156:9 contents is not a valid Response Object key. Did you mean content? oas3-schema
160:24 Unresolved $ref — schemas/Erorr does not exist. ref-resolution
162:7 Operation has no operationId. It will be skipped when generating MCP tools. operation-operationId
السطر 156، العمود 9 YAML UTF-8 المسافات: 2 3.1.0
مجموعات مُنشأة من openapi.yaml استيراد Postman فحص العقد مفعّل
GET ▾
{{baseUrl}}/users/{{userId}}?include=profile
بيئة الاختبار ▾
المعاملات1 المصادقةbearer الترويسات3 المحتوى البرامج النصية الإعدادات
# GET has no requestBody in the specification — body disabled
# Path parameter id resolved from environment → userId = usr_8Kd2Xa
200 OK 148 ms 1.2 KB العقد: عدم تطابق واحد
المحتوى الترويسات9 ملفات تعريف الارتباط العقد1 الخط الزمني 
{
  "id": "usr_8Kd2Xa",
  "email": "ada@example.com",
  "created": 1757030400,
  "profile": {
    "name": "Ada L.",
    "locale": "en-GB"
  },
  "scope": "users:read orders:read"
}
Contract mismatch — response differs from the specification scope is present in the response but is not declared on components/schemas/User. Add the property to the schema or remove it from the handler.
mcp://localhost:7433 قيد التشغيل stdio + HTTP

مُنشأ من openapi.yaml

6 أدوات 7 موارد أداة واحدة محدودة إعادة الإنشاء عند الحفظ

Every operation with an operationId becomes a tool. Arguments come from parameters and requestBody. Nothing is hand-written.

POST /auth/login → operationId → loginUser
loginUser

Exchange credentials for a bearer token.

email : string password : string
سليم args from requestBody
GET /users/{id} → operationId → getUser
getUser

Retrieve a single user by identifier.

id : string include? : string
سليم args from 2 parameters
POST /orders → operationId → createOrder
createOrder

Create an order for the authenticated customer.

items : array currency : string
سليم args from requestBody
POST /orders/{id}/refund → operationId → refundOrder
refundOrder

Refund an order in full or in part.

id : string amount? : integer
محدود amount has no description
14:02:11 watch openapi.yaml changed (line 144)
14:02:11 build parsed 3.1.0 · 11 operations · 14 schemas
14:02:11 build 6 أدوات, 7 resources · 1 skipped (no operationId)
14:02:12 serve listening on stdio and http://localhost:7433
14:02:31 call getUser { id: "usr_8Kd2Xa" } → 200 in 148 ms
docs.example.dev/reference/users/get تصدير ثابت متزامن مع المواصفة

Retrieve a user

GET /v1/users/{id}

Returns the user object for a valid identifier. If the user has been deleted, an Error object is returned with status 404.

معاملات المسار
id string مطلوب
The identifier of the user, prefixed with usr_.
معاملات الاستعلام
include string
Expand a related object.

شاهدها في مسار عمل

حوّل الأعمال المعتادة إلى مسارات تستند إلى العقد.

اختر مهمة أدناه. ينفذها Powerduck من ملف OpenAPI على جهازك، مع البيئات والاختبارات والمحاكاة، دون حساب أو رفع ملفات.

العمل المحلي لا يعني إمكانات أقل.

ابدأ مساحة API المحلية دون حساب أو رفع ملفات. استخدم طلباتك ومصادقتك وبيئاتك وتأكيدات الاختبار. اختر Cloud عندما تريد النشر عبر الإنترنت.

  • استيراد cURL / Postman / OpenAPI
  • المصادقة والبيئات
  • السكربتات وتأكيدات الاختبار
  • المجموعات واختبارات السيناريوهات
  • خوادم محاكاة محلية
  • تصحيح أخطاء 7 بروتوكولات

العمل المحلي لا يحتاج إلى حساب. يستخدم الذكاء الاصطناعي البعيد خدمة النموذج التي تختارها؛ وتتطلب الاستضافة عبر الإنترنت حساب Cloud.

ما العمل الذي تريد التوقف عن تكراره يدويًا؟

استكشف هذه السيناريوهات

هل ما زلت تقرأ الشيفرة المصدرية للتأكد من صحة توثيق API؟

أنشئ التوثيق من المشروع.

تعريف API قابل للمراجعة ورابط توثيق محلي.

عرض الإعداد والمتطلبات

قدمت المواصفة إلى الذكاء الاصطناعي، فحصلت على حقول ومسارات مختلفة؟

نفّذ وفق عقد API الفعلي.

تنفيذ يستند إلى العقد، وفحص باستخدام استجابات فعلية.

عرض الإعداد والمتطلبات

هل تكرر مسار الأعمال نفسه يدويًا بعد كل تغيير في API؟

شغّل سيناريو الأعمال كاملاً.

نتائج لكل خطوة وتأكيدات الاختبار الفاشلة، لا مجرد سكربت اختبار مُنشأ.

عرض الإعداد والمتطلبات

هل تبدّل الأدوات لمجرد أن نقطة الاتصال التالية تستخدم بروتوكولاً مختلفًا؟

افحص سبعة بروتوكولات في مكان واحد.

تحكم يدوي عندما تحتاج إلى معرفة ما حدث بدقة.

عرض الإعداد والمتطلبات

هل تنسخ الطلبات والاستجابات إلى المحادثة كلما احتجت إلى مساعدة الذكاء الاصطناعي؟

حقق باستخدام سياق الطلب الفعلي.

تشخيص يستند إلى نتائج الطلبات، مع تغييرات يمكنك مراجعتها.

عرض الإعداد والمتطلبات

هل تدير استضافة منفصلة لمجرد مشاركة توثيق API وMCP؟

انشر التوثيق وMCP من API واحدة.

توثيق مستضاف وعنوان MCP، دون تشغيل بنية استضافة خاصة بك.

عرض الإعداد والمتطلبات

ابدأ على جهازك

نزّله، واعمل في بيئتك الخاصة.

Powerduck مساحة API لسطح المكتب. افتح ملفًا محليًا وأرسل أول طلب، ثم اربط وكيل البرمجة عندما تكون مستعدًا. لا تحتاج إلى حساب للبدء.

مساحة العمل الأساسية

اجعلها منصة عملك مع API.

هنا تجد الملفات المحلية وفحص الشيفرة وتصحيح البروتوكولات الأصلية. اربط نموذج الذكاء الاصطناعي الذي تختاره عندما تحتاج إلى مساعدة في التصميم أو التحقيق أو الاختبار.

  1. 1 نزّل التطبيق وجرّب المثال المحلي، دون حساب أو مفتاح نموذج.
  2. 2 افتح ملف OpenAPI أو افحص قاعدة شيفرة موجودة.
  3. 3 اربط وكيل برمجة وعدّل الشيفرة، ثم تحقق من الواجهة الخلفية الفعلية وفق العقد.
تنزيل تطبيق سطح المكتب

macOS 12+ · Windows 10+ · Linux

تريد إلقاء نظرة أولاً؟

جرّب جولة سريعة في المتصفح.

يستخدم عرض الويب نموذجًا سحابيًا مشتركًا ويتطلب تسجيل الدخول. للعمل محليًا دون حساب، نزّل تطبيق سطح المكتب.

فتح تطبيق الويب

التحقق من العقد

خطأ حقيقي في العقد، ثم إصلاح تم التحقق منه

يرسل عميل API المعتاد الطلب ويعرض الاستجابة. يفحص Powerduck أيضًا كل استجابة وفق عقد OpenAPI، فيكتشف الاختلاف عن المواصفة فور حدوثه.

شاهد مثالاً قابلاً للتشغيل
~/commerce-api — response check OpenAPI 3.1
ما يشترطه العقد
total:
  type: number
الواجهة الخلفية تعيد نصًا 
{
  "total": "49.00"
}
يجب أن تكون /total عددًا — الاستجابة تخالف العقد
أعد عددًا 
{
  "total": 49
}
الاستجابة تطابق العقد

محرر مواصفات OpenAPI

محرر مواصفات OpenAPI

يتبع المخطط البنية الفعلية للمواصفة بدلاً من تخمينها من المسافات البادئة. تصفّح المسارات والمكونات كشجرة، وأصلح الأخطاء في مواضعها.

  • تحقق يراعي المخطط. تحقق وفق صيغة 3.0 أو 3.1 أو 3.2 التي يعلنها ملفك فعليًا.
  • التنقل عبر مراجع $ref. انتقل إلى التعريفات وافحص مواضع الاستخدام واحصل على اقتراحات للمراجع المكتوبة خطأً.
  • تعديل في الملف نفسه. يبقى مستودعك مصدر الحقيقة.
  • تشخيص مع أسماء القواعد. تستخدم أخطاء التكامل المستمر وتشخيصات المحرر المصطلحات نفسها.
openapi.yaml 3 مشكلات
▾ info
▾ paths
　/users
　/users/{id}
　/orders
▾ components
　schemas
　responses
142 /users/{id}:
143 get:
144 operationId: getUser
145 responses:
156 contents:
160 $ref: Erorr
المشكلات · خطآن · تحذير واحد
156:9 contents is not a valid Response Object key
160:24 Unresolved $ref. Closest match: Error
تصحيح API فحص العقد مفعّل
▾ Users
　GET listUsers
　GET getUser
▾ Orders
　POST createOrder
GET {{baseUrl}}/users/{{userId}} إرسال
المعاملات المصادقة المحتوى الترويسات 
{
  "id": "usr_8Kd2Xa",
  "email": "ada@example.com",
  "scope": "users:read"
}
Contract mismatch — "scope" is not declared on User.

تصحيح أخطاء API

تصحيح أخطاء API وفق مواصفتك

منشئ طلبات مألوف للمطورين، مع إمكانية إضافية: التحقق من الاستجابات وفق العقد.

  • مجموعات من المسارات والوسوم. دون استيراد أو إعادة مزامنة يدوية.
  • فحص العقد لكل استجابة. اكتشف الخصائص غير المعلنة والحقول المفقودة واختلاف الأنواع داخل الاستجابة مباشرةً.
  • البيئات والمتغيرات. أعد استخدام إعدادات التطوير وبيئة ما قبل الإنتاج الحالية.
  • المصادقة من securitySchemes. تبدأ إعدادات Bearer ومفتاح API وOAuth من المواصفة.

منشئ خوادم MCP

أنشئ خادم MCP من OpenAPI

تحتوي مواصفتك بالفعل على تعريفات الأدوات. يحوّلها Powerduck إلى خادم MCP قابل للتشغيل ويبيّن حقول OpenAPI التي نتجت عنها كل أداة.

  • مصدر واضح. يمكن تتبّع كل أداة إلى العملية وoperationId والمخطط الأصلي.
  • إظهار القيود والعناصر المتجاوزة. تظهر البيانات الوصفية الناقصة بدلاً من إنشاء أدوات غير مكتملة بصمت.
  • إعادة الإنشاء عند الحفظ. غيّر المواصفة فتتحدث الأدوات دون خطوة بناء منفصلة.
  • وسائل نقل محلية. شغّل عبر stdio أو HTTP للوكلاء ومسارات العمل المحلية.
mcp://localhost:7433 قيد التشغيل
مُنشأ من openapi.yaml 6 أدوات 7 موارد
GET /users/{id} → operationId
getUser
id: string
POST /orders → operationId
createOrder
items: array
POST /auth/login
loginUser
email, password
DELETE /users/{id}
تم التخطي
operationId مفقود
14:02 build 6 tools, 7 resources
14:02 serve listening on :7433
14:03 call getUser → 200
مرجع API تصدير ثابت
Users
نظرة عامة
Retrieve a user
List users
Update user

Retrieve a user

GET /v1/users/{id}
Returns the user object for a valid identifier.
معاملات المسار
id · string · required
القيمة المُعادة
User · object
curl /users/{id}

{
  "id": "usr_...",
  "email": "ada@..."
}

منشئ توثيق API

توثيق API من العقد نفسه

أنشئ توثيقًا مرجعيًا مباشرةً من نموذج OpenAPI، وصدّره كملفات ثابتة واستضفه حيث تريد.

  • جداول المعلمات من المخططات. تبقى الحقول الإلزامية والقيم المعدّدة والأوصاف متزامنة.
  • أمثلة بلغات متعددة. أنشئ أمثلة cURL وNode وPython وGo من العمليات.
  • استجابات من العقد الفعلي. تأتي استجابات النجاح والأخطاء من الكائنات نفسها التي يتحقق منها مصحح الأخطاء.
  • تصدير ثابت. دون اعتماديات وقت تشغيل أو ارتباط بمنصة توثيق بعينها.

مصدر حقيقة واحد

ملف OpenAPI محلي واحد.
كل الإمكانات، مع الذكاء الاصطناعي.

افتح openapi.yaml أو openapi.json محليًا ليحوّل Powerduck عقدك إلى مساحة API متكاملة. دون استيراد أو تحويل أو مجموعات موازية أو نسخة سحابية. صف النتيجة بلغة طبيعية، فينفذها المساعد المدمج عبر خطوات قابلة للمراجعة. ويتصل الملف نفسه عبر MCP بأي وكيل برمجة بالذكاء الاصطناعي.

افتح محليًا
{ }
openapi.yaml
أو openapi.json

يبقى الملف في مستودعك.

01 محرر المواصفات

عدّل العقد الفعلي وتصفّحه وتحقق منه.

02 تصحيح أخطاء API

أرسل طلبات منشأة من العمليات نفسها.

03 خادم MCP

حوّل العمليات إلى أدوات جاهزة للوكلاء.

04 توثيق API

انشر التوثيق من المصدر نفسه.

Powerduck

أكثر من عميل API.
أكثر من عارض مواصفات.
مساحة لبناء API مع الذكاء الاصطناعي.

مساحة عمل محلية مدعومة بالذكاء الاصطناعي تتمحور حول ملف OpenAPI نفسه.

دون حاجة إلى السحابةلا تحتاج إلى رفع المواصفة للعمل محليًا.
دون مزامنة يدويةلا توجد مواد منفصلة تحتاج إلى مزامنتها مع العقد.
دون نسخة إضافيةملف YAML أو JSON الحالي هو مساحة عملك.

العمل المحلي والخدمات البعيدة وخياراتك

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

سياسة الخصوصية

لا يتطلب الاستخدام المحلي شراء Cloud. تتيح الخطة المجانية مواصفتين، ويمكن لمكافآت المشاركة المعتمدة زيادة الحد. يزيل ترخيص سطح المكتب حدّ عدد المواصفات. يحاسبك مزود النموذج على استخدام مفتاحك الخاص؛ أرصدة النماذج المستضافة واستضافة Cloud منفصلة.

اختر خطوتك التالية.

قارن المنتجات والأسعار →
طوّر محليًا

ترخيص سطح المكتب

صمّم واجهات API وصحح أخطاءها واختبرها عبر المحادثة باستخدام ملفات OpenAPI المحلية.

شراء لمرة واحدة · ترخيص دائم انشر على الإنترنت

استضافة Cloud

شارك توثيق API وخدمات MCP المستضافة مع فريقك ووكلاء الذكاء الاصطناعي.

خطة مجانية · خطط شهرية أو سنوية اختر نموذجك

أرصدة الذكاء الاصطناعي

استخدم النماذج المستضافة بحزمة أرصدة، أو اضبط مزود نموذجك الخاص في تطبيق سطح المكتب.

أرصدة نماذج مسبقة الدفع

الأسئلة الشائعة

ما يسأل عنه المطورون أولاً

تفاصيل عملية عن الملفات المحلية وإصدارات OpenAPI وإنشاء MCP والترخيص.

هل يرفع Powerduck مواصفة OpenAPI الخاصة بي إلى أي مكان؟

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

ما إصدارات OpenAPI المدعومة؟

OpenAPI 3.0 و3.1 و3.2. يكتشف Powerduck الإصدار المعلن ويتحقق وفق صيغته المناسبة، بدلاً من الاكتفاء بالحد الأدنى المشترك.

كيف يُنشأ خادم MCP؟

تصبح العمليات التي تحتوي على operationId أدوات MCP. تُشتق الوسيطات من المعلمات ومخططات requestBody. ويمكن إتاحة مخططات المكونات كموارد. يتحدث الخادم المُنشأ كلما تغيرت المواصفة.

هل ترخيص سطح المكتب اشتراك؟

لا. Powerduck Desktop ترخيص دائم يُشترى مرة واحدة، ويتضمن التحديثات ضمن الإصدار الرئيسي نفسه. تبقى الترقية إلى الإصدارات الرئيسية اللاحقة اختيارية.

هل يمكنني الاستمرار في استخدام مجموعات Postman؟

نعم. يمكنك مواصلة استخدام المجموعات والبيئات الحالية. يعتمد Powerduck مواصفة OpenAPI كعقد مرجعي ويساعدك على تحديد مواضع اختلاف الطلبات عنه.

هل يعمل في التكامل المستمر؟

نعم. يتوفر محرك التحقق والتوليد نفسه عبر @powerduck/openapi-cli، وهي أداة سطر أوامر جاهزة للتكامل المستمر تعمل في طلبات السحب ومسارات التشغيل الآلية. تدعم الاختبار الجماعي عبر 6 بروتوكولات (HTTP وSSE وWebSocket وgRPC وMCP وGraphQL)، وضبط التزامن، وتقارير متوافقة مع JUnit للتكامل مع CI.

استكشف openapi-cli →