MediaWiki API documentation

مقدمه

MediaWiki یک نرم‌افزار ویکی متن‌باز و رایگان است که توسط جیمی ولز، لری سنگر و دیگران توسعه یافته است. این نرم‌افزار اساس پروژه‌هایی مانند ویکی‌پدیا، ویکی‌مدیا کامنز و بسیاری از ویکی‌های دیگر را تشکیل می‌دهد. API (برنامه نویسی واسط کاربر) MediaWiki به توسعه‌دهندگان امکان می‌دهد تا به صورت برنامه‌نویسی با هسته ویکی تعامل داشته باشند. این تعامل می‌تواند شامل خواندن و نوشتن داده‌ها، مدیریت کاربران، تغییر تنظیمات و انجام بسیاری از عملیات دیگر باشد. مستندات API MediaWiki منبع اصلی برای درک و استفاده از این قابلیت‌ها است. این مقاله به عنوان یک راهنمای جامع برای مبتدیان در زمینه استفاده از مستندات API MediaWiki طراحی شده است.

چرا از API MediaWiki استفاده کنیم؟

استفاده از API MediaWiki مزایای متعددی دارد:

• **اتوماسیون:** انجام وظایف تکراری به صورت خودکار، مانند ایجاد یا به‌روزرسانی صفحات.
• **یکپارچه‌سازی:** ادغام ویکی با سایر سیستم‌ها و برنامه‌ها.
• **توسعه ربات:** ایجاد ربات‌های ویکی برای انجام وظایف خاص.
• **دسترسی به داده‌ها:** استخراج داده‌های ویکی برای تجزیه و تحلیل یا نمایش در برنامه‌های دیگر.
• **توسعه ابزار:** ساخت ابزارهای جدید برای کاربران و مدیران ویکی.

دسترسی به مستندات API

مستندات API MediaWiki در آدرس زیر در دسترس است:

[[1]]

این صفحه اصلی نقطه شروع برای تمام اطلاعات مربوط به API است. مستندات به طور منظم به‌روزرسانی می‌شود تا تغییرات در نرم‌افزار MediaWiki را منعکس کند.

ساختار مستندات

مستندات API MediaWiki به بخش‌های مختلفی تقسیم می‌شود که هر کدام به جنبه خاصی از API می‌پردازند:

• **API:Main page:** صفحه اصلی که لینک‌هایی به سایر بخش‌ها را ارائه می‌دهد.
• **API:Tutorials:** آموزش‌های گام به گام برای شروع کار با API.
• **API:Categories:** دسته‌بندی‌های مختلف API بر اساس عملکرد.
• **API:Modules:** ماژول‌های API که هر کدام مجموعه‌ای از عملکردها را ارائه می‌دهند.
• **API:Parameters:** پارامترهای مختلفی که می‌توان برای هر عملکرد API استفاده کرد.
• **API:Error codes:** کدهای خطا که API ممکن است برگرداند.
• **API:Authentication:** روش‌های احراز هویت برای دسترسی به API.

مفاهیم کلیدی API MediaWiki

چندین مفهوم کلیدی وجود دارد که برای درک API MediaWiki ضروری است:

• **ماژول‌ها (Modules):** ماژول‌های API مجموعه‌ای از عملکردها هستند که برای انجام وظایف خاصی طراحی شده‌اند. به عنوان مثال، ماژول "action=parse" برای تجزیه متن ویکی استفاده می‌شود.
• **عملکردها (Actions):** عملکردها دستورالعمل‌هایی هستند که به API ارسال می‌شوند. هر عملکرد یک کار خاص را انجام می‌دهد.
• **پارامترها (Parameters):** پارامترها مقادیری هستند که به عملکردها ارسال می‌شوند تا نحوه عملکرد آنها را کنترل کنند.
• **فرمت خروجی (Output format):** API می‌تواند داده‌ها را در فرمت‌های مختلفی برگرداند، از جمله JSON و XML.
• **احراز هویت (Authentication):** برای دسترسی به برخی از عملکردهای API، باید خود را احراز هویت کنید. این معمولاً با استفاده از توکن‌های API انجام می‌شود.
• **نرخ محدودیت (Rate limiting):** API دارای محدودیت‌هایی در تعداد درخواست‌هایی است که می‌توانید در یک بازه زمانی معین ارسال کنید. این برای جلوگیری از سوء استفاده و اطمینان از عملکرد پایدار سیستم است.

مثال‌های عملی

گرفتن عنوان یک صفحه

برای گرفتن عنوان یک صفحه، می‌توانید از ماژول "action=query" و عملکرد "title" استفاده کنید.

``` https://yourwiki.com/api.php?action=query&titles=Main%20Page&prop=info&format=json ```

در این مثال، `yourwiki.com` نام دامنه ویکی شما است، `Main Page` عنوان صفحه‌ای است که می‌خواهید اطلاعات آن را دریافت کنید، `prop=info` مشخص می‌کند که می‌خواهید اطلاعات صفحه را دریافت کنید و `format=json` مشخص می‌کند که می‌خواهید خروجی را در قالب JSON دریافت کنید.

ویرایش یک صفحه

برای ویرایش یک صفحه، می‌توانید از ماژول "action=edit" استفاده کنید.

``` https://yourwiki.com/api.php?action=edit&title=Main%20Page&summary=Update%20page&text=This%20is%20the%20new%20content.&token=YOUR_EDIT_TOKEN ```

در این مثال، `Main Page` عنوان صفحه‌ای است که می‌خواهید ویرایش کنید، `summary` خلاصه ویرایش است، `text` محتوای جدید صفحه است و `token` یک توکن ویرایش است که برای جلوگیری از ویرایش‌های مخرب استفاده می‌شود.

لیست کردن صفحات در یک دسته

برای لیست کردن صفحات در یک دسته، می‌توانید از ماژول "action=query" و عملکرد "categorymembers" استفاده کنید.

``` https://yourwiki.com/api.php?action=query&list=categorymembers&cmtitle=Category:Help&cmtype=page&format=json ```

در این مثال، `Category:Help` نام دسته‌ای است که می‌خواهید صفحات آن را لیست کنید، `cmtype=page` مشخص می‌کند که فقط صفحات را لیست کنید و `format=json` مشخص می‌کند که می‌خواهید خروجی را در قالب JSON دریافت کنید.

ابزارهای کمکی

چندین ابزار کمکی وجود دارد که می‌تواند به شما در استفاده از API MediaWiki کمک کند:

• **cURL:** یک ابزار خط فرمان برای ارسال درخواست‌های HTTP.
• **Postman:** یک برنامه GUI برای ارسال درخواست‌های HTTP.
• **PHP:** یک زبان برنامه‌نویسی سمت سرور که می‌تواند برای تعامل با API استفاده شود.
• **Python:** یک زبان برنامه‌نویسی چند منظوره که می‌تواند برای تعامل با API استفاده شود.
• **JavaScript:** یک زبان برنامه‌نویسی سمت کلاینت که می‌تواند برای تعامل با API در مرورگر وب استفاده شود.

استراتژی‌های مرتبط، تحلیل تکنیکال و تحلیل حجم معاملات

در حالی که مستندات API MediaWiki به طور مستقیم با تحلیل تکنیکال یا حجم معاملات مرتبط نیست، درک نحوه بازیابی و پردازش داده‌ها از طریق API می‌تواند برای این اهداف مفید باشد. به عنوان مثال:

• **تحلیل روند ویرایش:** با استفاده از API، می‌توان تاریخچه ویرایش یک صفحه را استخراج کرد و روند تغییرات محتوا را بررسی کرد. این می‌تواند برای شناسایی موضوعات داغ یا در حال ظهور مفید باشد. Moving Averages
• **تحلیل ترافیک صفحه:** با استفاده از API، می‌توان تعداد بازدید از یک صفحه را استخراج کرد و الگوهای ترافیکی را شناسایی کرد. Bollinger Bands
• **تحلیل مشارکت کاربران:** با استفاده از API، می‌توان مشارکت کاربران در ویکی را بررسی کرد و الگوهای رفتاری را شناسایی کرد. Relative Strength Index (RSI)
• **شناسایی ربات‌ها:** با تحلیل الگوهای ویرایش، می‌توان ربات‌ها را از ویرایش‌های انسانی تشخیص داد. Fibonacci Retracements
• **تحلیل احساسات (Sentiment Analysis):** با استخراج محتوای صفحات و استفاده از تکنیک‌های پردازش زبان طبیعی، می‌توان احساسات موجود در محتوا را تحلیل کرد. MACD
• **تحلیل کلمات کلیدی:** با استخراج کلمات کلیدی از صفحات، می‌توان موضوعات اصلی ویکی را شناسایی کرد. Volume Weighted Average Price (VWAP)
• **تحلیل لینک‌های داخلی و خارجی:** با بررسی لینک‌های موجود در صفحات، می‌توان ساختار ویکی و ارتباطات بین صفحات را درک کرد. On Balance Volume (OBV)
• **تحلیل تغییرات در دسته‌ها:** با بررسی تغییرات در دسته‌ها، می‌توان الگوهای سازماندهی محتوا را شناسایی کرد. Ichimoku Cloud
• **تحلیل حجم ویرایش:** با بررسی تعداد ویرایش‌ها در یک بازه زمانی معین، می‌توان فعالیت ویکی را اندازه‌گیری کرد. Average True Range (ATR)
• **شناسایی صفحات یتیم:** با شناسایی صفحاتی که هیچ لینک ورودی ندارند، می‌توان صفحات نیازمند بهبود یا حذف را شناسایی کرد. Parabolic SAR
• **تحلیل همبستگی بین صفحات:** با بررسی الگوهای لینک‌دهی بین صفحات، می‌توان ارتباطات بین موضوعات مختلف را شناسایی کرد. Stochastic Oscillator
• **پیش‌بینی روند ویرایش:** با استفاده از داده‌های تاریخی ویرایش، می‌توان تلاش کرد روند ویرایش آینده را پیش‌بینی کرد. Elliott Wave Theory
• **تحلیل تغییرات در طول زمان:** با مقایسه داده‌های API در بازه‌های زمانی مختلف، می‌توان تغییرات در ویکی را در طول زمان ردیابی کرد. Donchian Channels
• **بررسی تأثیر رویدادهای خارجی:** با مقایسه داده‌های API با رویدادهای خارجی، می‌توان تأثیر این رویدادها بر فعالیت ویکی را بررسی کرد. Candlestick Patterns
• **تحلیل شبکه‌های اجتماعی:** با استفاده از API و داده‌های شبکه‌های اجتماعی، می‌توان تعامل کاربران با ویکی را در شبکه‌های اجتماعی بررسی کرد. Support and Resistance Levels

نکات مهم

• همیشه مستندات رسمی API را به عنوان منبع اصلی اطلاعات خود در نظر بگیرید.
• قبل از شروع به نوشتن کد، مستندات مربوط به ماژول و عملکردی که می‌خواهید استفاده کنید را به دقت مطالعه کنید.
• از ابزارهای کمکی برای تسهیل فرآیند توسعه استفاده کنید.
• به محدودیت‌های نرخ API توجه کنید و درخواست‌های خود را بهینه کنید.
• از احراز هویت مناسب برای دسترسی به عملکردهای محافظت شده استفاده کنید.
• در صورت بروز خطا، کدهای خطا را بررسی کنید تا علت مشکل را شناسایی کنید.
• از فرمت خروجی مناسب برای نیازهای خود استفاده کنید.

نتیجه‌گیری

API MediaWiki ابزاری قدرتمند برای تعامل برنامه‌نویسی با هسته ویکی است. با درک مفاهیم کلیدی و استفاده از مستندات API، می‌توانید برنامه‌ها و ابزارهایی را ایجاد کنید که قابلیت‌های ویکی را گسترش می‌دهند و فرآیندهای خود را خودکار می‌کنند. این راهنما به شما کمک می‌کند تا سفر خود را در دنیای API MediaWiki آغاز کنید و از پتانسیل کامل این فناوری بهره‌مند شوید.

شروع معاملات الآن

ثبت‌نام در IQ Option (حداقل واریز $10) باز کردن حساب در Pocket Option (حداقل واریز $5)

به جامعه ما بپیوندید

در کانال تلگرام ما عضو شوید @strategybin و دسترسی پیدا کنید به: ✓ سیگنال‌های معاملاتی روزانه ✓ تحلیل‌های استراتژیک انحصاری ✓ هشدارهای مربوط به روند بازار ✓ مواد آموزشی برای مبتدیان