الانتقال إلى المحتوى الرئيسي

نظرة عامة

يتيح لك Web2MD REST API تحويل أي صفحة ويب أو HTML خام إلى Markdown نظيف برمجيًا. استخدمه لبناء خطوط معالجة (pipelines)، أو أتمتة استيراد المحتوى، أو دمج Web2MD في أدواتك الخاصة.
يتطلب REST API خطة PRO. أنشئ مفتاح API الخاص بك من لوحة تحكم Web2MD.

مواصفات قابلة للقراءة الآلية

استخدم مواصفات OpenAPI لتوليد SDKs للعملاء تلقائيًا أو استيرادها في أدوات مثل Postman وSwagger UI أو أطر عمل وكلاء AI.

المصادقة

يجب أن تتضمن جميع الطلبات مفتاح API الخاص بك في ترويسة Authorization:
مفاتيح API تبدأ بالبادئة w2m_ وترتبط بحسابك.

نقطة النهاية (Endpoint)

POST https://web2md.org/api/v1/convert

محتوى الطلب

قدّم إما url أو html، وليس كلاهما. سيفشل الطلب بخطأ 400 إذا كان كلاهما موجودًا أو لم يُقدَّم أي منهما.

الخيارات

الاستجابة

تُرجع الاستجابة الناجحة ما يلي:

حدود معدل الطلبات

طلبات API محدودة بمعدل 60 طلبًا في الدقيقة لكل مفتاح API. إذا تجاوزت الحد، يُرجع API رمز الحالة 429. انتظر نافذة إعادة التعيين قبل إعادة المحاولة.

استجابات الخطأ

تتبع جميع استجابات الخطأ هذا الشكل:

أمثلة

تحويل رابط باستخدام curl

تحويل HTML خام باستخدام curl

JavaScript (fetch)

خزّن مفتاح API الخاص بك في متغير بيئة بدلًا من كتابته مباشرة في الكود. على سبيل المثال، استخدم process.env.WEB2MD_API_KEY في Node.js.