رابط کاربری سیپنل و WHM راهکاری جامع برای مدیریت سرور ارائه میدهند. اما شرکتهای ارائهدهنده هاست و توسعهدهندگان عموماً تمایل دارند تا فرایندها را بهصورت خودکار تبدیل کنند و ابزارهای سیپنل را با دیگر نرمافزارها ادغام کنند.
برای سادهتر کردن این امر، سیپنل مجموعهای از API را ارائه داده است. در این مقاله به بررسی این API ها پرداخته و درباره روش استفاده از آنها خواهیم گفت.
API سیپنل چیست؟
API یا همان رابط برنامهنویسی کاربردی در سیپنل و WHM به کاربران این امکان را میدهند تا بهراحتی به قابلیتهای داخلی نرمافزارها دسترسی پیدا کند. برای استفاده از این مجموعه API، نیاز است کاربر دستوری ارسال کرده و سپس سیپنل به آن پاسخ دهد. درست مانند انجام عملیات بر روی سرور و دادههای داخلی.
اما استفاده از API چند مزیت دارد:
کاربران میتوانند وظایف را بهصورت خودکار کرده و از انجام دستی آن بینیاز شوند.
API به سیپنل این امکان را میدهد تا با ابزارهای دیگر هماهنگ شود.
شما میتوانید از API برای گسترش و تقویت قابلیتهای سیپنل استفاده کنید. در واقع بسیاری از افزونهها بر پایه API ساخته میشوند.
دسترسی API سیپنل از طریق سرور
دو ابزار برای نوشتن اسکریپت و اجرای دستورات بر روی سرور ارائه شده است:
- برای WHM: whmapi
- برای سیپنل: uapi
هر کدام از این API ها ویژگیهای لازم را برای سیپنل یا WHM ارائه میدهند و تفاوتهایشان نیز در همین است. استفاده از هر دوی آنها نیز آسان است. اما باید توجه داشته باشید برای کار با آنها باید SSL داشته باشید.
با کمک دستور زیر میتوانید با استفاده whmapi اطلاعات لازم را از سرور دریافت کنید:
whmapi list_users
در اینجا دستور همانطور که انتظار دارید فهرستی از کاربران سرور را به همراه متادیتا ارائه میدهد. حالا میتوانیم نگاهی دقیقتر به یکی از حسابهای خاص بیندازیم. در دستور زیر کلمه user1 را با نام کاربر جایگزین کنید.
whmapi1 accountsummary user=user1
یکی از نکات مهم در هنگام شروع کار با API درک کارکرد masquerading است. اگرچه API سیپنل برای اجرا در سیپنل طراحی شده است، اما یک کاربر روت (root user) میتواند با کمک دستور زیر عملیات مربوطه را انجام دهد.
uapi –user=user1 DomainInfo list_domains
تا به اینجا توضیح دادیم که چطور اطلاعات موردنیاز را به کمک API از سرور به دست بیاوریم. در ادامه درباره موضوعات دیگری نیز صحبت خواهیم کرد.
دسترسی به API سیپنل بهصورت ریموت
علاوه بر ابزارهایی که تابهحال نام بردیم، شما میتوانید از هر دو API سیپنل و WHM از طریق HTTP بهصورت ریموت استفاده کنید. در واقع هر زبان برنامهنویسی یا ابزاری که قابلیت ارسال درخواست HTTP را داشته باشد، میتواند به API دست پیدا کند.
اما دقیقاً به همین دلیل است که باید بیشازپیش دراینرابطه اقدامات امنیتی را رعایت کنید. برای این کار از چند ابزار میتوانید استفاده کنید:
- ابزارهای احراز هویت در سیپنل و WHM
- انجام درخواستهای API با استفاده از CURL
سخن پایانی
به کمک APIهای سیپنل و WHM میتوانید به سادهترین حالت فرایند و عملیات سرور خود را انجام برسانید و حتی آنها را به شکل خودکار تنظیم کنید. البته در این میان لازم است به امنیت نیز توجه داشته و احتیاط لازم را پیش بگیرید.
