اتصال به API
برای ارسال یا دریافت اطلاعات از سرویسهای خارجی. دو حالت: API مستقیم و Data Connector (آزمایشی).
پیشنیازها
- آدرس و متد API سرویس مقصد
- برای Data Connector: اتصالدهنده از قبل ساخته و تست شده
API مستقیم
افزودن عملیات
از پالت، اتصال به API را به گره اضافه کنید.
انتخاب یا ساخت API
در استفاده از API یک API ذخیرهشده انتخاب کنید یا API جدید بسازید.
پیکربندی
| بخش | توضیح |
|---|---|
| نام API | شناسایی در لیست فلو |
| URL و Method | آدرس و GET/POST/… |
| Query Params | پارامترهای کوئری — {{order_id}} یا {{$phone}} |
| Body | JSON یا Form-Data |
| Headers | هدرهای درخواست |
| Response | نگاشت JSON به متغیرهای فلو |
در نگاشت پاسخ: سمت چپ مسیر JSON (مثلاً data.status)، سمت راست نام متغیر.
خروجیها
دو مسیر: موفق و ناموفق. مسیر ناموفق را برای پیام خطا به کاربر وصل کنید.
⚠️
پاسخ باید JSON باشد تا نگاشت به متغیر ممکن شود.
Data Connector (آزمایشی)
اگر اتصالدهنده در تنظیمات ساختهاید:
- تب Data Connector را باز کنید.
- کانکتور را انتخاب کنید.
- نگاشت ورودیها را از متغیرهای فلو پر کنید.
- نگاشت پاسخ را با مسیرهایی مثل
data.items[0].nameتنظیم کنید.
اتصالدهندهها در تنظیمات مدیریت میشوند و در فلورا هم قابل استفادهاند.
متغیرها در درخواست
در URL، هدر، پارامتر و بدنه با قالب Mustache ({{نام}}) مقداردهی میشوند:
https://api.example.com/orders/{{order_id}}
Authorization: Bearer {{api_token}}متغیرهای سیستمی هم با همان قالب و پیشوند $ قابل استفادهاند: {{$userId}}
مثال: استعلام وضعیت سفارش
- دریافت پیام → ذخیره
order_id - API GET →
https://api.shop.com/orders/{{order_id}} - نگاشت
data.status→ متغیرstatus - شرط روی
status→ پیام مناسب
نتیجه: کاربر وضعیت واقعی سفارش را میبیند.
عیبیابی
| مشکل | راهحل |
|---|---|
| همیشه مسیر ناموفق | URL، هدر و فرمت body را در لاگ API چک کنید |
| متغیر خالی | مسیر JSON در نگاشت پاسخ را بررسی کنید |
| Data Connector خطا | ابتدا تست پاسخ در تنظیمات کانکتور را بگیرید |
آخرین تغییر در