نانوپمستندات n8n فارسی

مستندات n8n

73+
نود مستند
۰
بازدید

ناوبری اصلی

دسترسی سریع

دسته‌بندی‌ها

🌐

درخواست HTTP

HTTP Request

ارسال درخواست HTTP به APIهای خارجی، دریافت و پردازش داده

ابزارهای توسعه
متوسط
ویژه
۰بازدید
اشتراک‌گذاری:
مستندات رسمی

نمای کلی

نود HTTP Request ابزاری همه‌کاره برای ارتباط با APIهای خارجی است.

قابلیت‌های کلیدی:

  • ارسال درخواست‌های GET, POST, PUT, DELETE, PATCH
  • کار با Header‌ها و Query Parameters
  • ارسال داده‌های JSON, Form Data, Multipart
  • احراز هویت (Basic, OAuth2, API Key)
  • مدیریت خطا و Timeout
  • دریافت و پردازش پاسخ

کاربردها:

  • یکپارچه‌سازی با APIهای شخص ثالث
  • ارسال داده به سرویس‌های خارجی
  • دریافت اطلاعات از منابع مختلف
  • تست و Debug کردن APIها

کاربردهای متداول

1. فراخوانی API خارجی

ارسال درخواست به APIهای عمومی مانند:

  • OpenWeatherMap (وضعیت هوا)
  • CurrencyAPI (نرخ ارز)
  • News API (اخبار)

2. یکپارچه‌سازی با سرویس‌های داخلی

ارتباط با API سرور خودتان:

  • ثبت داده در دیتابیس
  • دریافت گزارش‌ها
  • فراخوانی Microservices

3. Webhook Handler

دریافت و پردازش Webhookها از سرویس‌های مختلف.

4. تست API

تست و Debug کردن APIهای در حال توسعه.

نکات حرفه‌ای

💡 نکات حرفه‌ای:

  1. 1استفاده از Expression: برای URLهای داینامیک از Expression استفاده کنید:
code
https://api.example.com/users/{{$json.userId}}
  1. 1مدیریت پاسخ: پاسخ API را با Set Node پردازش کنید.
  1. 1Retry on Fail: گزینه Retry را برای درخواست‌های مهم فعال کنید.
  1. 1Log Response: برای Debug، پاسخ را در Console ببینید.
  1. 1Content-Type: برای POST/PUT:
  • JSON: application/json
  • Form: application/x-www-form-urlencoded
  1. 1Query Parameters: به جای URL، از بخش Query Parameters استفاده کنید (تمیزتر است).
  1. 1Environment Variables: API Keyها را در Environment Variables ذخیره کنید.

رفع مشکلات

خطاهای رایج

1. خطای 401 Unauthorized

علت: API Key یا Token اشتباه

راه‌حل

  • API Key را بررسی کنید
  • فرمت Authorization Header را چک کنید
  • تاریخ انقضا را بررسی کنید

2. خطای 404 Not Found

علت: آدرس URL اشتباه است

راه‌حل

  • URL را از مستندات API بررسی کنید
  • Endpoint صحیح را وارد کنید

3. خطای 429 Too Many Requests

علت: محدودیت Rate Limit

راه‌حل

  • تعداد درخواست‌ها را کاهش دهید
  • از Wait Node استفاده کنید
  • Rate Limit API را بررسی کنید

4. Timeout Error

علت: سرور پاسخ نمی‌دهد

راه‌حل

  • Timeout را افزایش دهید
  • اتصال اینترنت را بررسی کنید
  • وضعیت سرور مقصد را چک کنید

5. CORS Error

علت: مشکل Cross-Origin

راه‌حل

  • از n8n استفاده کنید (مشکل CORS ندارد)
  • یا Proxy استفاده کنید

آیا این مستندات مفید بود؟

100٪ این مستندات را مفید دانسته‌اند