رفتن به محتوا
بازگشت به صفحهٔ اصلی

API و وب هوک ها

همه چیز بدون n8n هم کار می کند. این بخش برای وقتی است که می خواهید رنکولوکس را به ابزارهای دیگر وصل کنید: تلگرام، Slack، Notion یا هر CMS.

فرمان ها به رنکولوکس (Trigger API)

با توکنی که در «تنظیمات ← اتوماسیون» می سازید. توکن فقط یک بار نمایش داده می شود و به یک فضای کاری تعلق دارد؛ پروژهٔ فضای کاری دیگر پاسخ ۴۰۴ می گیرد.

POST /api/automation/trigger
Authorization: Bearer ulux_...
Content-Type: application/json

{ "action": "crawl", "projectId": "..." }
  • کارها: crawl، plan-tasks، gsc-sync، gsc-inspect، ga4-sync، pagespeed، crux، rank-check.

رویدادها از رنکولوکس (امضاشده)

هر رویداد با HMAC-SHA256 بر بدنهٔ خام و رمز امضای کانال امضا می شود:

x-ulux-event: <event>
x-ulux-signature: sha256=<hmac>
{ "id", "event", "at", "workspaceId", "data" }
  • رویدادها: audit.finished، alert.created، tasks.created، draft.ready، content.approved (با Markdown، HTML و نشانی تصویر ها)، test.ping.
  • در صورت خطای شبکه یا ۵xx یک بار دوباره تلاش می شود و گیرندهٔ خراب هرگز کار را متوقف نمی کند.

الگوهای n8n

الگو ها از روی قالب مستند n8n نوشته شده اند و روی یک n8n زنده اجرا نشده اند؛ بعد از واردکردن، هر نود را بررسی کنید.