شروع کار با API

در این بخش با روش تایید هویت و دسترسی به وب سرویس های ثمین آشنا خواهید شد. API های ثمین در سه دسته زیر قرار می گیرند:

GAPI

api های عمومی ثمین در این دسته قرار دارند. برای مثال دریافت مقالات سایت از طریق این وب سرویس امکان پذیر است. دسترسی از طریق این api ها بدون نیاز به Authentication خواهد بود.

XAPI

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

API

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

برای اتصال به API ثمین شما نیاز به یک کلید دسترسی Access token خواهید داشت. این توکن به روش های مختلفی طبق استاندارد OAuth 2.0 قابل ایجاد است. بیایید با ساده ترین روش این کار را شروع نماییم. در این روش شما یک کلید دسترسی شخصی برای اتصال به حساب کاربری ثمینتان خواهید ساخت. این روش برای آزمایش اپلیکیشن و در مرحله توسعه سرویس یا اپلیکیشنتان مفید خواهد بود.

دریافت کلید دسترسی شخصی

وارد داشبورد خود شده و از پنل اصلی وارد بخش دسترسی ها > کلید شخصی شوید.

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

توجه: برای توسعه سرویس خود بهتر است از یک فروشگاه آزمایشی شروع نمایید.

پس از کلیک بر روی گزینه ایجاد، Access token ایجاد و به شما نمایش داده خواهد شد. دقت نمایید این توکن تنها یک بار نمایش داده شده و امکان دریافت مجدد آن وجود ندارد.

کلید فوق را کپی نمایید. از این کلید در ارسال درخواست ها و برای تایید هویت استفاده خواهید نمود. برای مثال برای دریافت لیست محصولات یک فروشگاه توکن فوق را به روش زیر در header درخواست خود قرار دهید. به قرار گیری عبارت Bearer پیش از کلید دقت نمایید.

%7B%22js%22%3A%22const%20url%20%3D%20new%20URL(%5C%22https%3A%2F%2Fselldone.com%2Fapi%2Fshops%2F%7Byour-shop-id%7D%2Fproducts%2Fall-admin%5C%22)%3B%5Cn%5Cn%20%20%20%20let%20params%20%3D%20%7B%20%7D%3B%5Cn%20%20%20%20Object.keys(params).forEach(key%20%3D%3E%20url.searchParams.append(key%2C%20params%5Bkey%5D))%3B%5Cn%5Cnlet%20headers%20%3D%20%7B%5Cn%20%20%20%20%5C%22Accept%5C%22%3A%20%5C%22application%2Fjson%5C%22%2C%5Cn%20%20%20%20%5C%22Content-Type%5C%22%3A%20%5C%22application%2Fjson%5C%22%2C%5Cn%20%20%20%20%5C%22Authorization%5C%22%3A%20%5C%22Bearer%20eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjhmMTc1MGQ3Yzk0ZmRlN2JlYjBmYThkZGUxNTE2OTk5NDE5NTY4Nzk0NmIxODQ0ODE1M...%5C%22%2C%5Cn%7D%5Cn%5Cnfetch(url%2C%20%7B%5Cn%20%20%20%20method%3A%20%5C%22GET%5C%22%2C%5Cn%20%20%20%20headers%3A%20headers%2C%5Cn%7D)%5Cn%20%20%20%20.then(response%20%3D%3E%20response.json())%5Cn%20%20%20%20.then(json%20%3D%3E%20console.log(json))%3B%22%7D

برای اطلاع بیشتر به مستندات API در این بخش مراجعه نمایید.








تنظیم برنامه حمل و نقل

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

دسته بندی محصولات

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

جستجوی محصولات و فیلتر کردن

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

تصاویر

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

فروش کارت هدیه

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

فروش آنلاین به صورت عمده

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

فروش در اینستاگرام

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

فروش در فیسبوک

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