تنظیمات API در ووکامرس

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

تنظیمات API در ووکامرس

برای دسترسی به تنظیمات API در ووکامرس کافیه از منوی ووکامرس، پیکربندی ووکامرس رو کلیک کنید بعد روی زبانه API بزنید تا وارد بخش تنظیمات API در ووکامرس شوید مانند تصویر زیر:

بعد از اینکه وارد تنظیمات ووکامرس شدید و روی زبانه API کلیک کردید صفحه مانند تصویر زیر ظاهر می شود:

شاید برپسید که API چیست و چه کاربردی دارد ابتدا در مورد API صحبت میکنیم و بعد توضیحات کاملی در این زمینه ارائه میدهیم.

API چیست؟

API مخفف واژگان Application Programming Interface به معنی “رابط های برنامه نویسی اپلیکیشن” می باشد. به طور خلاصه، ای پی آی به راحتی این امکان را در اختیار یک برنامه نویس می‌دهد تا به‌ برخی یا تمامی قابلیت‌های یک نرم‌افزار دیگر دسترسی پیدا کند.

خوب متوجه شدیم API چیست حالا یک نمونه مثال از API در وردپرس میدهیم تا متوجه کاربرد API در وردپرس شوید. 

مثالی از وردپرس API در افزونه های وردپرسی

مثلا شما میخواهید وردپرس را به یک سرویس خبرنامه ای مثل میل چیمپ، میلرلایت و … وصل کنید برای اتصال بین وردپرس و این سرویس ها باید از API استفاده کنید. مثلا وقتی افزونه خبرنامه رو نصب میکنید یک بخشی برای درجج API دارد. شما وارد سرویس مثلا میل چیمپ می شوید و از بخش API یک API جدید میسازید معمولا API ها یک کد طولانی است این کد را در افزونه وردپرس درج میکنید و بعد وردپرس و میل چیمپ به هم وصل می شوند. تصویر زیر رو ببینید.

خوب احتمالا تا الان کامل متوجه شدید که API چی هستش، چه کاربردی دارد و چگونه استفاده می شود. 

تقریبا نحوه کاربرد API در ووکامرس همانند وردپرس است. در ووکامرس از API برای اتصال به بیرون از وردپرس استفاده می شود. حال چطور تنظیمات API در ووکامرس را انجام دهیم. من سعی میکنم تمام تنظیمات API در ووکامرس را توضیح دهم تا در صورتی که خواستید از API استفاده کنید دچار مشکل نشوید. 

در مرحله اول شما باید بدونید چطور کلید API ووکامرس فعال می شود. کافیه از زبانه API، تیک گزینه فعال سازی REST API را بزنید و روی دکمه ذخیره تغییرات رو کلیک کنید.

بعد از اینکه API رو فعال کردید باید بدونید چطور کلید API بسازید. کافیه روی گزینه کلیدها/برنامه ها کلیک کنید و بعد روی افزودن کلید (ساخت کلید API) بزنید مانند تصویر زیر:

بعد از اینکه ساخت کلید API رو زدید صفحه ای مانند تصویر زیر نمایان می شود:

توجه: کلید api ووکامرس همانند کلید سیستم، دسترسی ها را کنترل می کند! در واقع این کلیدها به کاربران وردپرس در وب سایت شما مرتبط است.

۱- توضیحات: در این فیلد باید توضیحاتی در مورد کلید مورد نظر وارد کنید. 
۲- کاربر: در این بخش باید کاربری که میخواهید برایش کلید بسازید رو انتخاب کنید. 
۳- دسترسی ها: در این فیلد باید دسترسی برای کلید API ووکامرس را انتخاب کنید. این سطح دسترسی می تواند خواندن، نوشتن و… باشد.

پس از انجام تنظیمات صفحه فوق بر روی دکمه ساخت کلید API کلیک کنید. در این حین ووکامرس برای کاربر مورد نظرتان کلید api ووکامرس ایجاد می کند.

صفحه جدیدی برای شما باز می شود که در این صفحه کلید برای کاربر مورد نظرتان ساخته شده است.

در این صفحه جزییات کلید ساخته شده مانند کلید مصرف کننده، رمز مصرف کننده و بارکد QR را مشاهده میکنید. در صورت نیاز به کلید api ، کاربران می توانند از کلید مصرف کننده و رمز مصرف کننده خودشان، استفاده کنند.

توجه: شما با استفاده از دکمه ابطال کلید، میتوانید این کلید را باطل کنید.

وب هوک‌ها در ووکامرس

در انتها به بخش وب هوک ها میرسیم. در ابتدا توضیحی در مورد وب هوک بدیم بدونید وب هوک چی هستش و به کاری میاد. در ابتدا باید بگویم، وب هوک یکی از بخش های افزونه ووکامرس در وردپرس بوده و محرک تغییرات فروشگاه است. وب هوک اساسا یک رویداد اطلاع رسانی است که به URL (آدرس) انتخابی شما ارسال میشود. کاربران میتوانند آن را برای رویداد هایی که اتفاق میفتد روی یک سایت، برای فراخوانی در سایت های دیگر پیکر بندی کنند.

نکته: وب هوک ها برای ادغام خدمات شخص ثالث و دیگر API های خارجی پشتیبانی کننده از آن ها بسیار مفید هستند.

نحوه ساخت وب هوک:

برای ساخت وب هوک کافیه از زبانه API، گزینه وب هوک رو بزنید و روی دکمه افزودن وب هوک (ایجاد یک webhook جدید) کلیک کنید مانند تصویر زیر:

بعد از اینکه دکمه افزودن وب هوک (ایجاد یک webhook جدید) رو زدید وارد بخش ساخت وب هوک جدید می شوید مانند تصویر زیر:

۱- نام: در این بخش باید نام وب هوک را مشخص کنید.
۲- وضعیت: در این فیلد وضعیت وب هوک را مشخص کنید که وب هوک فعال باشد، متوقف شود یا غیرفعال شد. 
۳- موضوع: در بخش موضوع بر اساس نیاز خود باید یک موضوع رو انتخاب کنید. باید ببینید وب هوک برای چه موضوع به درد شما می خورد.
۴-پیوند تحویل: در این قسمت URL است که بار وب هوک تحویل داده شده است.
۵-محرمانه: این قسمت کلید محرمانه ای است که یک هش از وب هوک تحویلی میسازد و در هدر درخواست ارائه میشود.
۶- نسخه API: در این بخش هم نسخه API رو مشخص میکنیم. 

ذخیره وب هوک: بعد از این تنظیمات مورد نظر رو انجام دادم روی دکمه ذخیره وب هوک کلیک میکنیم تا وب هوک ساخته شود.