Skip to Content

اتصال به API

برای ارسال یا دریافت اطلاعات از سرویس‌های خارجی. دو حالت: API مستقیم و Data Connector (آزمایشی).

پیش‌نیازها

  • آدرس و متد API سرویس مقصد
  • برای Data Connector: اتصال‌دهنده از قبل ساخته و تست شده

API مستقیم

افزودن عملیات

از پالت، اتصال به API را به گره اضافه کنید.

انتخاب یا ساخت API

در استفاده از API یک API ذخیره‌شده انتخاب کنید یا API جدید بسازید.

پیکربندی

بخشتوضیح
نام APIشناسایی در لیست فلو
URL و Methodآدرس و GET/POST/…
Query Paramsپارامترهای کوئری — {{order_id}} یا {{$phone}}
BodyJSON یا Form-Data
Headersهدرهای درخواست
Responseنگاشت JSON به متغیرهای فلو

در نگاشت پاسخ: سمت چپ مسیر JSON (مثلاً data.status)، سمت راست نام متغیر.

خروجی‌ها

دو مسیر: موفق و ناموفق. مسیر ناموفق را برای پیام خطا به کاربر وصل کنید.

⚠️

پاسخ باید JSON باشد تا نگاشت به متغیر ممکن شود.

Data Connector (آزمایشی)

اگر اتصال‌دهنده در تنظیمات ساخته‌اید:

  1. تب Data Connector را باز کنید.
  2. کانکتور را انتخاب کنید.
  3. نگاشت ورودی‌ها را از متغیرهای فلو پر کنید.
  4. نگاشت پاسخ را با مسیرهایی مثل data.items[0].name تنظیم کنید.

اتصال‌دهنده‌ها در تنظیمات مدیریت می‌شوند و در فلورا هم قابل استفاده‌اند.

متغیرها در درخواست

در URL، هدر، پارامتر و بدنه با قالب Mustache ({{نام}}) مقداردهی می‌شوند:

https://api.example.com/orders/{{order_id}} Authorization: Bearer {{api_token}}

متغیرهای سیستمی هم با همان قالب و پیشوند $ قابل استفاده‌اند: {{$userId}}

مثال: استعلام وضعیت سفارش

  1. دریافت پیام → ذخیره order_id
  2. API GET → https://api.shop.com/orders/{{order_id}}
  3. نگاشت data.status → متغیر status
  4. شرط روی status → پیام مناسب

نتیجه: کاربر وضعیت واقعی سفارش را می‌بیند.

عیب‌یابی

مشکلراه‌حل
همیشه مسیر ناموفقURL، هدر و فرمت body را در لاگ API چک کنید
متغیر خالیمسیر JSON در نگاشت پاسخ را بررسی کنید
Data Connector خطاابتدا تست پاسخ در تنظیمات کانکتور را بگیرید
آخرین تغییر در