اتصالدهندههای داده
اتصالدهنده (Data Connector) تعریف قابلاستفادهٔ مجدد از یک API است — در فلورا و عملیات اتصال به API فلو استودیو.
مسیر: /settings/data-connectors (قابلیت بتا)
🧪
این بخش آزمایشی است و ممکن است جزئیات رابط کاربری در نسخههای بعدی تغییر کند.
پیشنیازها
- آدرس، متد و فرمت پاسخ API سرویس مقصد
- دسترسی تست API (Postman یا معادل)
ساخت اتصالدهنده
هر اتصالدهنده پنج تب دارد:
۱. درباره
| فیلد | توضیح |
|---|---|
| نام | نام نمایشی در لیست |
| کلید | شناسهٔ یکتا برای انتخاب در فلو/فلورا |
| توضیحات | راهنمای استفاده برای تیم (در فلورا هم دیده میشود) |
۲. اتصال API
| بخش | توضیح |
|---|---|
| فیلدهای ورودی | پارامترهایی که هنگام فراخوانی پر میشوند |
| Method و Endpoint | GET/POST و آدرس |
| Headers | هدرهای احراز هویت و … |
| Body | بدنهٔ درخواست در صورت نیاز |
۳. تست پاسخ API
- پاسخ زنده: با مقادیر نمونه API را صدا بزنید.
- JSON ثابت: برای توسعه بدون دسترسی به API واقعی.
تا وقتی تست درست نباشد، به فلو یا فلورا وصل نکنید.
۴. تبدیل داده
- برگرداندن همهٔ فیلدها، یا
- فیلتر/تبدیل خروجی تا فقط فیلدهای لازم به فلو/فلورا برسد.
۵. لاگها
لاگهای تست و عملیاتی با فیلتر:
- وضعیت (موفق/ناموفق)
- بازهٔ زمانی
- شناسه مکالمه / چتبات / فلورا
استفاده پس از ساخت
تست و ذخیره
در تب تست پاسخ را تأیید کنید و اتصالدهنده را ذخیره کنید.
در فلورا
از تنظیمات فلورا همان کانکتور را انتخاب کنید تا هنگام پاسخ از دادهٔ زنده استفاده شود.
در فلو استودیو
در اتصال به API تب Data Connector را باز کنید، کانکتور را انتخاب و ورودی/پاسخ را نگاشت کنید.
مثال: استعلام وضعیت سفارش
- درباره: نام «پیگیری سفارش»، کلید
order_status - API: GET
https://api.shop.com/orders/{order_id} - ورودی:
order_idاز متغیر فلو - تبدیل: فقط
statusوetaبرگردد - در فلو: نگاشت به متغیر و نمایش به کاربر
نتیجه: فلورا یا فلو بدون تکرار تنظیم API، همان کانکتور را استفاده میکنند.
عیبیابی
| مشکل | راهحل |
|---|---|
| تست ناموفق | URL، هدر و body را در تب اتصال API چک کنید |
| فیلد در فلو خالی است | نگاشت تبدیل داده و مسیر JSON را بررسی کنید |
| لاگ خطا | تب لاگها → فیلتر وضعیت ناموفق |
مرتبط
آخرین تغییر در