چگونه میتوانم n8n را به اپلیکیشن Bubble خود متصل کنم؟

شما میتوانید با استفاده از نود HTTP Request در n8n و پیکربندی آن برای فراخوانی API دادههای اپلیکیشن Bubble خود، اتصال را برقرار کنید. این شامل تنظیم URL صحیح، متد HTTP و احراز هویت با استفاده از توکن API است.

چه اطلاعاتی برای اتصال Bubble API نیاز دارم؟

شما به URL نقطه پایانی API اپلیکیشن Bubble خود (شامل نسخه و نوع داده) و توکن API (که در تنظیمات API اپلیکیشن Bubble شما یافت میشود) نیاز دارید. همچنین باید نام هدر مربوط به توکن API را بدانید.

چگونه میتوانم دادهها را از Bubble با n8n بازیابی کنم؟

با استفاده از یک تریگر دستی برای شروع Workflow و سپس یک نود HTTP Request که برای ارسال درخواست GET به نقطه پایانی API دادههای Bubble شما پیکربندی شده است، میتوانید دادهها را بازیابی کنید. خروجی نود HTTP Request حاوی دادههای بازیابی شده خواهد بود.

دسترسی به داده‌های Bubble با n8n: راهنمای گام به گام

دسترسی به داده‌های اپلیکیشن Bubble با n8n

این راهنما نحوه دسترسی به داده‌ها از یک اپلیکیشن Bubble.io با استفاده از n8n را نشان می‌دهد. این راهنما مثالی عملی از اتصال n8n به API داده‌های اپلیکیشن Bubble شما برای بازیابی اطلاعات در صورت نیاز ارائه می‌دهد.

شما می‌توانید این Workflow و موارد دیگر را در کاتالوگ Axeto n8n ما پیدا کنید.

نمای کلی Workflow

این Workflow به عنوان اثبات مفهوم برای نشان دادن فرآیند بازیابی داده‌ها از یک اپلیکیشن Bubble طراحی شده است. این Workflow از یک تریگر دستی برای شروع فرآیند بازیابی داده‌ها استفاده می‌کند و پس از آن یک نود HTTP Request که برای تعامل با API داده‌های اپلیکیشن Bubble شما پیکربندی شده است.

این Workflow از دو جزء اصلی تشکیل شده است:

1. Manual Trigger: زمانی که نیاز به بازیابی داده‌ها دارید، اجرای Workflow را آغاز می‌کند.

2. HTTP Request: برای ارسال یک درخواست GET احراز هویت شده به نقطه پایانی API اپلیکیشن Bubble شما برای بازیابی داده‌های خاص پیکربندی شده است.

تشریح گام به گام

۱. Manual Trigger

هدف: این نود به عنوان نقطه شروع Workflow شما عمل می‌کند. این به شما امکان می‌دهد تا هر زمان که نیاز به بازیابی داده‌ها از اپلیکیشن Bubble خود دارید، اجرای Workflow را به صورت دستی آغاز کنید.
نوع نود: n8n-nodes-base.manualTrigger
پیکربندی: هیچ پارامتر خاصی برای این نود مورد نیاز نیست. این نود با تنظیمات پیش‌فرض خود کار می‌کند.
اجرا: برای شروع Workflow، دکمه "Execute" را روی نود کلیک کنید.
اتصالات: این نود به نود "HTTP Request" بعدی متصل است و به آن سیگنال می‌دهد تا با فراخوانی API ادامه دهد.

۲. HTTP Request به Bubble API

هدف: این نود مسئول ارسال درخواست واقعی به API اپلیکیشن Bubble شما برای بازیابی داده‌های مورد نظر است.
نوع نود: n8n-nodes-base.httpRequest
پیکربندی:

* URL: این را به نقطه پایانی API اپلیکیشن Bubble خود تنظیم کنید. به عنوان مثال: https://your-bubble-app.bubbleapps.io/version-test/api/1.1/obj/your_data_type

* your-bubble-app.bubbleapps.io را با دامنه واقعی اپلیکیشن Bubble خود جایگزین کنید.

* version-test را می‌توان به live تغییر داد اگر می‌خواهید به داده‌های تولید دسترسی پیدا کنید.

* your_data_type باید با نوع داده خاصی که می‌خواهید به آن دسترسی پیدا کنید (به عنوان مثال، user، product) جایگزین شود.

* HTTP Method: اطمینان حاصل کنید که این روی GET تنظیم شده است.

* Authentication:

* HTTP Header Authentication را انتخاب کنید.

* شما نیاز به ایجاد یا انتخاب یک اعتبارنامه HTTP Header Auth دارید. این اعتبارنامه باید توکن API و نام هدر مربوطه را که توسط اپلیکیشن Bubble شما برای دسترسی به API مورد نیاز است، شامل شود. برای این جزئیات به تنظیمات API اپلیکیشن Bubble خود مراجعه کنید.

اجرا: این نود سیگنال تریگر را از نود Manual Trigger دریافت کرده و درخواست GET پیکربندی شده HTTP را اجرا می‌کند.
خروجی: خروجی این نود شامل داده‌های بازیابی شده از API اپلیکیشن Bubble شما خواهد بود.

خلاصه ساختار Workflow

نام نود	نوع نود	نقش	نود(های) ورودی	نود(های) خروجی
Manual Trigger	`manualTrigger`	اجرای Workflow را آغاز می‌کند	None	HTTP Request
HTTP Request	`httpRequest`	داده‌ها را از Bubble API بازیابی می‌کند	Manual Trigger	None

نحوه بازسازی این Workflow

1. افزودن Manual Trigger:

* نود "Manual Trigger" (n8n-nodes-base.manualTrigger) را جستجو و اضافه کنید.

* هیچ پیکربندی برای این نود لازم نیست.

2. افزودن نود HTTP Request:

* نود "HTTP Request" (n8n-nodes-base.httpRequest) را جستجو و اضافه کنید.

* پیکربندی URL: نقطه پایانی API خاص برای نوع داده Bubble خود را وارد کنید.

* تنظیم HTTP Method: اطمینان حاصل کنید که روی GET تنظیم شده است.

* پیکربندی Authentication:

* "HTTP Header Authentication" را انتخاب کنید.

* یک اعتبارنامه جدید ایجاد کنید یا یک اعتبارنامه موجود را انتخاب کنید.

* در تنظیمات اعتبارنامه، کلید هدر HTTP لازم (به عنوان مثال، Authorization) و مقدار توکن API را که از تنظیمات API اپلیکیشن Bubble شما به دست آمده است، ارائه دهید.

3. اتصال نودها:

* یک فلش از نود "Manual Trigger" به نود "HTTP Request" بکشید.

4. ذخیره و تست:

* Workflow خود را ذخیره کنید.

* برای تست بازیابی داده‌ها از اپلیکیشن Bubble خود، دکمه "Execute" را روی نود "Manual Trigger" کلیک کنید.

ملاحظات مهم

توکن API Bubble: اطمینان حاصل کنید که توکن API Bubble شما به درستی در اعتبارنامه HTTP Header Auth پیکربندی شده است و مجوزهای لازم را در اپلیکیشن Bubble شما دارد.
نسخه API: URL مثال از version-test استفاده می‌کند. هنگام دسترسی به داده‌ها از محیط تولیدی Bubble خود، به یاد داشته باشید که آن را به live تغییر دهید.
انواع داده: شما می‌توانید URL را برای بازیابی داده‌ها از هر یک از انواع داده‌های اپلیکیشن Bubble خود تطبیق دهید.
مستندات API Bubble: برای اطلاعات دقیق در مورد API Bubble، به مستندات رسمی API Bubble مراجعه کنید.