اعتبارنامه‌های Shopify#
می‌توانید از این اعتبارنامه‌ها برای احراز هویت نودهای زیر با Shopify استفاده کنید.
روش‌های احراز هویت پشتیبانی‌شده#
- توکن دسترسی (پیشنهادی): برای برنامه‌های خصوصی/فروشگاه‌های فردی. قابل ایجاد توسط مدیران عادی.
- OAuth2: برای برنامه‌های عمومی. باید توسط حساب‌های شریک ساخته شود.
- کلید API: منسوخ شده.
منابع مرتبط#
برای اطلاعات بیشتر درباره سرویس، به مستندات احراز هویت Shopify مراجعه کنید.
استفاده از توکن دسترسی#
جهت پیکربندی این اعتبارنامه، نیازمند یک حساب کاربری ادمین Shopify و موارد زیر هستید:
- زیردامنه فروشگاه شما
- یک توکن دسترسی: هنگام ساختن برنامه سفارشی تولید می‌شود.
- یک کلید مخفی برنامه (APP Secret Key): هنگام ساختن برنامه سفارشی تولید می‌شود.
برای راه‌اندازی این اعتبارنامه، باید یک برنامه سفارشی بسازید و نصب کنید:
- وارد زیردامنه فروشگاه خود شوید.
- زیردامنه شما در آدرس URL قرار دارد:
https://<subdomain>.myshopify.com؛ مثلا اگر URL کاملhttps://n8n.myshopify.comباشد، زیردامنهn8nاست. - در Shopify، به مدیریت > تنظیمات > برنامه‌ها و کانال‌های فروش بروید.
- گزینه توسعه برنامه‌ها را انتخاب کنید.
- گزینه ایجاد برنامه سفارشی را برگزینید.
/// نکته | این گزینه را نمی‌بینید؟ اگر این گزینه را نمی‌بینید، احتمالاً فروشگاه شما امکان توسعه برنامه‌های سفارشی فعال نیست. برای فعال‌سازی، به بخش فعال‌سازی توسعه برنامه‌های سفارشی مراجعه کنید. ///
- در پنجره‌ی مدال، نام برنامه را وارد کنید.
- توسعه‌دهنده برنامه را انتخاب کنید. توسعه‌دهنده می‌تواند مالک فروشگاه باشد یا هر حساب کاربری با مجوز توسعه برنامه‌ها.
- گزینه ایجاد برنامه را بزنید.
- بر روی انتخاب دامنه‌های دسترسی کلیک کنید. در بخش دامنه‌های دسترسی API مدیریت، دامنه‌های API موردنیاز برنامه خود را انتخاب کنید.
- برای استفاده از تمام قابلیت‌های نود Shopify، دامنه‌های
read_orders،write_orders،read_products، وwrite_productsرا اضافه کنید. - برای اطلاعات بیشتر درباره مجوزهای دسترسی به API Shopify، به دامنه‌های دسترسی API Shopify مراجعه کنید. - گزینه ذخیره را بزنید.
- گزینه نصب برنامه را انتخاب کنید.
- در پنجره‌ی مدال، روی نصب برنامه کلیک کنید.
- بخش اعتبارنامه‌های API برنامه را باز کنید.
- توکن دسترسی API ادمین را کپی کنید و در بخش توکن دسترسی در اعتبارنامه n98n خود وارد کنید.
- کلید مخفی API را کپی کنید و در بخش کلید مخفی برنامه در اعتبارنامه n98n وارد کنید.
برای کسب اطلاعات بیشتر درباره ساخت برنامه سفارشی و تولید توکن‌های دسترسی، به لینک‌های زیر مراجعه کنید: - ساخت برنامه سفارشی - تولید توکن‌های دسترسی برای برنامه‌های سفارشی در بخش مدیریت Shopify
استفاده از OAuth2#
جهت پیکربندی این اعتبارنامه، نیازمند یک حساب شریک Shopify و موارد زیر هستید:
- یک کلاینت آیدی: هنگام ساختن برنامه سفارشی تولید می‌شود.
- یک کلید مخفی کلاینت: هنگام ساختن برنامه سفارشی تولید می‌شود.
- زیردامنه فروشگاه شما
برای راه‌اندازی این اعتبارنامه، باید یک برنامه سفارشی بسازید و نصب کنید:
/// نکته | توسعه برنامه‌های سفارشی Shopify قالب‌هایی برای ساخت برنامه‌های جدید فراهم کرده است. دستورات زیر تنها بخش‌های لازم برای تنظیم اعتبارنامه n98n شما را پوشش می‌دهد. برای اطلاعات بیشتر درباره ساخت برنامه و کار کردن با قالب‌های برنامه، به مستندات توسعه Shopify مراجعه کنید. ///
- وارد بخش پیشخوان شریک Shopify شوید.
- از منوی سمت چپ، برنامه‌ها را انتخاب کنید.
- گزینه ایجاد برنامه را بزنید.
- در بخش استفاده از شریک‌های Shopify، یک نام برنامه وارد کنید.
- گزینه ایجاد برنامه را انتخاب کنید.
- پس از بازشدن جزئیات برنامه، کلاینت آیدی را کپی کنید و در اعتبارنامه n98n وارد کنید.
- کلید مخفی کلاینت را کپی کنید و در اعتبارنامه n98n وارد کنید.
- در منوی سمت چپ، به پیکربندی بروید.
- در n8n، آدرس بازگشت OAuth را کپی کرده و در قسمت آدرس‌های بازگشتی مجاز در بخش آدرس‌ها قرار دهید.
- در بخش آدرس‌ها، یک آدرس معتبر برنامه وارد کنید. میزبان وارد شده باید با میزبان آدرس‌های بازگشتی مجاز، مثلا آدرس پایه فروشگاه شما، مطابقت داشته باشد.
- گزینه ذخیره و انتشار را بزنید.
- از منوی سمت چپ، معرفی را انتخاب کنید. در این مرحله، می‌توانید برنامه‌تان را به صورت آزمایشی نصب کنید یا برای توزیع عمومی، گزینه انتخاب توزیع را برگزینید.
- در n8n، زیردامنه فروشگاهی که برنامه را نصب کرده‌اید، وارد کنید، چه به عنوان آزمایش و چه برای توزیع.
- زیردامنه شما در آدرس URL قرار دارد:
https://<subdomain>.myshopify.com؛ مثلا اگر URL کاملhttps://n8n.myshopify.comباشد، زیردامنهn8nاست.
استفاده از کلید API#
/// هشدار | روش منسوخ شده Shopify دیگر کلیدهای API با پسورد ایجاد نمی‌کند. به جای آن، از روش توکن دسترسی استفاده کنید. ///
برای پیکربندی این اعتبارنامه، نیازمند موارد زیر هستید:
- یک کلید API
- یک پسورد
- زیردامنه فروشگاه شما: زیردامنه در آدرس URL قرار دارد:
https://<subdomain>.myshopify.com؛ مثلا اگر URL کاملhttps://n8n.myshopify.comباشد، زیردامنهn8nاست. - اختیاری: یک کلید مخفی مشترک (Shared Secret)
مشکلات رایج#
در ادامه، مشکلات رایج هنگام راه‌اندازی اعتبارنامه Shopify و راه‌حل‌ها و راهکارهای رفع آن‌ها آمده است.
فعال‌سازی توسعه برنامه‌های سفارشی#
اگر گزینه ایجاد برنامه سفارشی را نمی‌بینید، شاید توسعه برنامه‌های سفارشی در فروشگاه شما فعال نشده است.
برای فعال‌سازی توسعه برنامه‌های سفارشی، باید یا به عنوان مالک فروشگاه وارد شوید و یا کسی با مجوز فعال‌سازی توسعه برنامه‌ها:
- در Shopify، به مدیریت > تنظیمات > برنامه‌ها و کانال‌های فروش بروید.
- گزینه توسعه برنامه‌ها را انتخاب کنید.
- گزینه فعال‌سازی توسعه برنامه‌های سفارشی را فعال کنید.
- هشدارها و اطلاعات نمایش داده شده را مطالعه و تایید کنید و گزینه فعال‌سازی توسعه برنامه‌های سفارشی را بزنید.
خطای مجوزهای اعتبارنامه#
اگر هنگام آزمایش اعتبارنامه، هشدار نمی‌توانم با این تنظیمات کانکشن برقرار کنم / ممنوع - شاید مجوزهای دسترسی API ظاهر شد، این مشکل ممکن است مربوط به وابستگی‌های دامنه‌های دسترسی API برنامه شما باشد. برای مثال، دامنه read_orders نیازمند دامنه read_products نیز است. مجوزهای اختصاص‌یافته و اقدامی که قصد دارید انجام دهید را بررسی کنید.