API چیست و چه کاربردی دارد؟

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

API مخفف کلمه Application Programming Interface به معنای رابط برنامه نویسی (کاربردی-اپلیکیشن-نرم افزار) است و مفهوم آن این است که شما می‌توانید با یک سری از دستورات و توابع، بین دو نرم افزار ارتباط برقرار کنید. به مفهوم ساده تر API همانند یک پل ارتباطی بین دو اپلیکیشن عمل می‌کند تا از قابلیت هر دو نرم افزار یا اپلیکیشن همزمان استفاده کنید.

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

API دیجی کالا چیست و چرا این مارکت‌پلیس آن را در اختیار عموم و همکاران تجاری خود قرار داده؟

همانطور که پیشتر به آن اشاره شد، API دیجی‌کالا یا وب‌سرویس دیجی‌کالا در واقع یک تابع کدگذاری شده برای استفاده فروشندگان دیجی‌کالا از سایر اپلیکیشن‌ها و نرم افزار است که به تبع استفاده از آن در پنل دیجی‌کالا باعث افزایش بهره‌وری و فروش برای سلرها می‌گردد. بطور مثال با استفاده از API فروشندگان دیجی‌کالا شما به راحتی می‌توانید از کلیه خدمات مارکیتو (ابزار مدیریت و فروش دیجی‌کالا و سایر کانال‌های فروش آنلاین) بهره‌مند شوید حتی می‌توانید به راحتی کلیه کالاهای موجود در پنل خود را با کلیه جزئیات به وب‌سایت شخصی خود منتقل و افزایش فروش قابل توجه‌ای را در این مارکت پلیس تجربه کنید.

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

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

مزایای استفاده از API دیجی کالا برای فروشندگان

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

استفاده از API برای فروشندگان در مارکت‌پلیس‌ها دارای مزایای بسیاری است:

امنیت و دسترسی محدود: API می‌تواند امکانات امنیتی فراهم کند که فروشندگان به داده‌ها و منابع مختلف با دسترسی محدود و مستقیم دسترسی داشته باشند.

استفاده از API نسبت به سیستم‌هایی که بر اساس یوزرنیم (USERNAME) و پسورد (PASSWORD) هستند، دارای مزایای زیادی است. یکی از مهم‌ترین مزایا، افزایش امنیت و کنترل بیشتر در ارتباطات و اطلاعات میان سیستم‌ها و خدمات مختلف است. با امکانات مدیریت دسترسی از طریق توکن‌ها، API به اپلیکیشن‌ها این امکان را می‌دهد که به صورت دقیق کنترل شوند و فقط به داده‌های لازم دسترسی پیدا کنند. همچنین، امکان رمزنگاری اطلاعات در ارتباطات با استفاده از API، امنیت اطلاعات را تضمین می‌کند. با ساختار متمرکز API، تغییرات در احراز هویت و دسترسی به سرورها به سهولت اعمال می‌شوند و نیاز به اطلاعات یوزر و پسورد در هر ارتباط را کاهش می‌دهد. این رویکرد باعث افزایش کارایی و امنیت در تبادل اطلاعات میان سرویس‌ها می‌شود.

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

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

اتصال سریع و موثر: API به شما فروشندگان این امکان را می‌دهد تا به سرعت و بدون مشکلات فنی با مارکت‌پلیس ارتباط برقرار کنید.

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

نحوه دریافت API از دیجی‌کالا و فعال سازی آن

ابتدا وارد پنل خود در دیجی کالا شوید، برای این منظور می‌بایست به سایت seller.digikala.com مراجعه کنید:

عکس صفحه ورود به پنل دیجی کالا برای دریافت API دیجی کالا

پس از ورود به داشبورد پنل خود، روی آیکون آدمک در سمت چپ بالای صفحه (شماره ۱) کلیک کنید. از منوی نمایش داده شده گزینه API (شماره ۲) را انتخاب کنید.

عکس منوی پنل دیجی کالا برای دریافت API دیجی کالا


نکته مهم: ممکن است در منوی باز شده، برای بعضی از فروشندگان دیجی‌کالا گزینه API فعال نباشد و یا گزینه API باشد اما با کلیک بر روی آن خطای زیر را مشاهده کنند:

عکس پیغام خطای API دیجی کالا

در چنین شرایطی می‌بایست برای فعالسازی گزینه API به طریق زیر عمل کرد:

ابتدا به قسمت درخواست پشتیبانی (شماره ۱) مراجعه کنید و روی ثبت درخواست پشتیبانی (شماره ۲) کلیک کنید.

عکس صفحه درخواست پشتیبانی برای دریافت API دیجی کالا

در این صفحه در قسمت انتخاب دسته بندی، ابتدا عملکرد فروشندگان (شماره ۱) و سپس در قسمت انتخاب موضوع گزینه سایر درخواست‌ها (شماره ۲) را انتخاب کنید و گزینه تایید و ادامه را می‌زنید.

عکس ثبت درخواست پشتیبانی برای گرفتن کد API دیجی کالا

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

عکس متن و عنوان درخواست برای ایجاد API دیجیکالا

این فرایند ممکن است از چند دقیقه تا حداکثر ۴۸ ساعت زمان ببرد. حال که گزینه API در منو فعال شد و یا از قبل فعال بود. به سراغ پنل دیجی‌کالا و گزینه API میرویم. پس از کلیک روی گزینه API وارد صفحه زیر می‌شوید، در این قسمت با کلیک روی گزینه ایجاد کلید جدید، کلید بصورت کد برای شما ایجاد و نمایش داده می‌شود.

عکس صفحه ایجاد کلید API دیجی کالا

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

صفحه کلیدهای API ایجاد شده و نحوه کپی کردن آنها

برای اتصال کانال دیجی‌کالا خود به مارکیتو وارد تنظیمات وب هوک شوید و مراحل زیر را انجام دهید:

با کلیک روی آدرس URL موجود در این بخش از مارکیتو، آن را کپی کرده و سپس وارد صفحه کلیدهای API شما از پنل دیجی‌کالای خود شوید و در ستون عملیات روی آیکون لیست وب‌هوک‌ها از کلید مورد نظر (کلید اضافه شده در مرحله قبل) کلیک کنید و سپس در صفحه WebHook های ثبت شده شما روی گزینه ایجاد webhook جدید کلیک کرده و آدرس URL خود را وارد و روی گزینه ایجاد کلیک کنید.

عکس صفحه تنظیمات وب هوک مارکیتو

حالا با کلیک روی توکن امنیتی ساخته شده در دیجی‌کالا، آن را کپی کرده و در قسمت توکن امنیتی مارکیتو وارد کنید و با کلیک روی گزینه ذخیره کانال دیجی‌کالای خود را به مارکیتو متصل کنید.

عکس وارد کردن توکن امنیتی در مارکیتو و اتصال به دیجی کالا

درصورت موفق بودن اتصال، این پیغام را مشاهده خواهید کرد.

عکس پیغام اتصال موفق API دیجی کالا به مارکیتو


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

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