ناشناس‌سازی خودکار رسانه با API BlurIt در n8n

ناشناس‌سازی چهره‌ها و پلاک خودروها در رسانه‌ها با BlurIt

این گردش کار، ناشناس‌سازی چهره‌ها و پلاک خودروها را در فایل‌های رسانه‌ای (تصاویر یا ویدئوها) با ادغام با API BlurIt خودکار می‌کند. این گردش کار برای موارد استفاده‌ای مانند ناشناس‌سازی فیلم‌های دوربین خودرو، امن‌سازی عکس‌ها قبل از اشتراک‌گذاری عمومی و اطمینان از انطباق با مقررات حریم خصوصی ایده‌آل است.

این گردش کار و موارد دیگر را در کاتالوگ n8n Axeto کاوش کنید.

---

نمای کلی گردش کار

این گردش کار به پنج بلوک عملکردی اصلی تقسیم شده است:

1. دریافت ورودی: دریافت فایل‌های رسانه‌ای آپلود شده از طریق یک فرم وب.

2. احراز هویت: دریافت توکن دسترسی از API BlurIt.

3. ایجاد وظیفه: ارسال فایل رسانه‌ای به BlurIt برای ناشناس‌سازی.

4. نظارت بر وظیفه: بررسی دوره‌ای وضعیت وظیفه ناشناس‌سازی.

5. بازیابی نتیجه: دانلود فایل رسانه‌ای ناشناس‌شده پس از اتمام موفقیت‌آمیز.

---

تحلیل جزئیات بلوک‌ها

۱. دریافت ورودی

این بلوک با استفاده از یک فرم کاربرپسند، آپلود اولیه فایل رسانه‌ای را مدیریت می‌کند.

• نودها:

* Upload Input File (تریگر فرم)

* Sticky Note (دستورالعمل آپلود فایل)

* Sticky Note (پیش‌نمایش ورودی تصویر)

• جزئیات نود:

* Upload Input File:

* نوع: n8n-nodes-base.formTrigger

* نقش: نقطه ورود گردش کار. یک وب‌هوک را نمایش می‌دهد که آپلود یک فایل رسانه‌ای را از طریق فرم می‌پذیرد.

* پیکربندی:

* مسیر وب‌هوک: یک شناسه منحصربه‌فرد برای وب‌هوک.

* عنوان فرم: "فرم آپلود رسانه".

* فیلد فرم: یک فیلد فایل واحد و الزامی به نام "input\_media".

* ورودی: ارسال فرم HTTP خارجی.

* خروجی: داده‌های فایل آپلود شده را برای نودهای بعدی منتشر می‌کند.

* موارد مرزی: تنظیم "الزامی" فرم از ارسال بدون فایل جلوگیری می‌کند. اعتبارسنجی نوع فایل یا مدیریت خرابی به صراحت پیاده‌سازی نشده است.

* Sticky Note (دستورالعمل آپلود فایل):

* پیوندهای مستقیمی به فرم برای محیط‌های تست و تولید ارائه می‌دهد.

* پیشنهاد می‌کند پس از آپلود برای مشاهده نتایج، نمای اجرای گردش کار را تازه کنید.

* Sticky Note (پیش‌نمایش ورودی تصویر):

* یک تصویر نمونه برای راهنمایی کاربران در مورد فرمت ورودی مورد انتظار نمایش می‌دهد.

---

۲. احراز هویت

این بلوک فرآیند احراز هویت را برای تعامل با API BlurIt مدیریت می‌کند.

• نودها:

* Set Auth Config (تنظیم)

* Auth Get Token (درخواست HTTP)

* Merge (ادغام)

* Sticky Note (دستورالعمل اعتبارنامه‌های BlurIt)

• جزئیات نود:

* Set Auth Config:

* نوع: n8n-nodes-base.set

* نقش: URL پایه API BlurIt، شناسه کلاینت و شناسه مخفی را ذخیره می‌کند.

* پیکربندی:

* BASE_URL: "https://api.services.wassa.io"

* CLIENT_ID: "[REPLACE\_BY\_YOUR\_CLIENT\_ID]" (نگهدارنده مکان)

* SECRET_ID: "[REPLACE\_BY\_YOUR\_SECRET\_ID]" (نگهدارنده مکان)

* خروجی: این مقادیر پیکربندی را به عنوان خصوصیات JSON به نود بعدی منتقل می‌کند.

* موارد مرزی: اعتبارنامه‌های نادرست یا گمشده منجر به شکست احراز هویت می‌شود.

* Auth Get Token:

* نوع: n8n-nodes-base.httpRequest

* نقش: یک درخواست POST به نقطه پایانی /login BlurIt برای دریافت توکن OAuth Bearer ارسال می‌کند.

* پیکربندی:

* URL: با استفاده از BASE_URL به صورت پویا ساخته می‌شود.

* بدنه: JSON حاوی clientId و secretId از نود Set Auth Config.

* ورودی: اعتبارنامه‌ها را از Set Auth Config دریافت می‌کند.

* خروجی: یک پاسخ JSON حاوی token منتشر می‌کند.

* حالت‌های شکست: خطاهای ۴۰۱ غیرمجاز برای اعتبارنامه‌های نامعتبر، قطع شدن شبکه، یا خطاهای تجزیه JSON.

* Merge:

* نوع: n8n-nodes-base.merge

* نقش: داده‌های فایل رسانه‌ای آپلود شده را با توکن احراز هویت به دست آمده ترکیب می‌کند و یک جریان داده واحد را برای مرحله بعدی آماده می‌سازد.

* پیکربندی: حالت ادغام روی "combineAll" تنظیم شده است.

* ورودی: داده‌ها از Upload Input File و Auth Get Token.

* خروجی: یک مورد ادغام شده واحد حاوی اطلاعات فایل و توکن.

* موارد مرزی: اگر هر یک از ورودی‌ها گمشده یا با تأخیر باشد، عملیات ادغام ممکن است تا ابد منتظر بماند.

* Sticky Note (دستورالعمل اعتبارنامه‌های BlurIt):

* راهنمایی در مورد محل دریافت CLIENT_ID و SECRET_ID لازم از داشبورد توسعه‌دهنده BlurIt ارائه می‌دهد.

* به کاربران یادآوری می‌کند که مقادیر نگهدارنده مکان را در نود Set Auth Config جایگزین کنند.

---

۳. ایجاد وظیفه

این بلوک با ارسال فایل رسانه‌ای و پیکربندی به API BlurIt، فرآیند ناشناس‌سازی را آغاز می‌کند.

• نودها:

* Create Blurit Task (درخواست HTTP)

* Sticky Note (دستورالعمل ایجاد وظیفه)

• جزئیات نود:

* Create Blurit Task:

* نوع: n8n-nodes-base.httpRequest

* نقش: یک درخواست POST به نقطه پایانی /innovation-service/anonymization BlurIt برای ایجاد یک کار ناشناس‌سازی ارسال می‌کند.

* پیکربندی:

* URL: با استفاده از BASE_URL به صورت پویا ساخته می‌شود.

* نوع محتوا: multipart/form-data برای آپلود فایل باینری.

* پارامترهای بدنه:

* input_media: داده‌های باینری فایل آپلود شده.

* activation_plates_blur: روی "true" تنظیم شده است.

* activation_faces_blur: روی "true" تنظیم شده است.

* blur_type: رشته JSON {"anonymization_type": "blur"}.

* هدرها: شامل توکن Bearer احراز هویت به دست آمده قبلی است.

* ورودی: داده‌های ادغام شده (فایل + توکن) از نود Merge.

* خروجی: یک پاسخ JSON حاوی anonymization_job_id که برای نظارت بر پیشرفت وظیفه حیاتی است.

* موارد مرزی: خطاهای احتمالی HTTP (مانند درخواست بد ۴۰۰ برای فایل‌های نامعتبر)، شکست‌های احراز هویت اگر توکن منقضی شده باشد، یا قطع شدن در حین آپلود فایل‌های بزرگ.

* Sticky Note (دستورالعمل ایجاد وظیفه):

* به کاربران در مورد نحوه سفارشی‌سازی تنظیمات محو کردن با ویرایش فیلد blur_type در این نود مشاوره می‌دهد.

---

۴. نظارت بر وظیفه

این بلوک یک مکانیزم نظرسنجی را برای پیگیری وضعیت وظیفه ناشناس‌سازی پیاده‌سازی می‌کند.

• نودها:

* Wait (انتظار)

* Get Task Status (درخواست HTTP)

* Switch (سوئیچ)

• جزئیات نود:

* Wait:

* نوع: n8n-nodes-base.wait

* نقش: یک تأخیر کوتاه (۲ ثانیه) بین درخواست‌های نظرسنجی برای جلوگیری از بارگذاری بیش از حد API ایجاد می‌کند.

* پیکربندی: مقدار انتظار روی ۲ ثانیه تنظیم شده است.

* ورودی: ورودی را از Create Blurit Task یا Switch (هنگامی که وظیفه در انتظار است) دریافت می‌کند.

* خروجی: پس از تأخیر مشخص شده، نود Get Task Status را فعال می‌کند.

* موارد مرزی: یک تأخیر ثابت ممکن است برای وظایفی با مدت زمان بسیار متغیر بهینه نباشد. عقب‌نشینی نمایی پیاده‌سازی نشده است.

* Get Task Status:

* نوع: n8n-nodes-base.httpRequest

* نقش: به طور دوره‌ای وضعیت کار ناشناس‌سازی را با استفاده از شناسه آن از API BlurIt پرس‌وجو می‌کند.

* پیکربندی:

* URL: با استفاده از BASE_URL به صورت پویا ساخته می‌شود.

* پارامتر پرس‌وجو: anonymization_job_id از پاسخ Create Blurit Task.

* هدرها: شامل توکن Bearer احراز هویت است.

* ورودی: از نود Wait یا ایجاد وظیفه اولیه.

* خروجی: یک پاسخ JSON حاوی status وظیفه و در صورت تکمیل، URL output_media.

* موارد مرزی: خطاهای API، قطع شدن، یا انقضای توکن می‌تواند باعث شکست شود.

* Switch:

* نوع: n8n-nodes-base.switch

* نقش: مسیر اجرای گردش کار را بر اساس وضعیت وظیفه دریافتی از Get Task Status هدایت می‌کند.

* پیکربندی:

* اگر status برابر "Succeeded" باشد: به Get Result File هدایت می‌کند.

* اگر status برابر "Failed" باشد: گردش کار را پایان می‌دهد.

* در غیر این صورت (مثلاً "Pending"): برای چرخه نظرسنجی بعدی به نود Wait هدایت می‌کند.

* ورودی: از Get Task Status.

* خروجی: خروجی‌های متعدد مطابق با شرایط وضعیت مختلف.

* موارد مرزی: مقادیر وضعیت پیش‌بینی نشده یا مستند نشده به صراحت مدیریت نمی‌شوند.

---

۵. بازیابی نتیجه

این بلوک نهایی فایل رسانه‌ای ناشناس شده را پس از اتمام موفقیت‌آمیز وظیفه دانلود می‌کند.

• نودها:

* Get Result File (درخواست HTTP)

* Sticky Note (دستورالعمل دریافت نتیجه)

* Sticky Note (پیش‌نمایش خروجی تصویر)

• جزئیات نود:

* Get Result File:

* نوع: n8n-nodes-base.httpRequest

* نقش: فایل رسانه‌ای ناشناس شده را از URL output_media ارائه شده در پاسخ وضعیت وظیفه دانلود می‌کند.

* پیکربندی:

* URL: به صورت پویا از خروجی نود Get Task Status به دست می‌آید.

* هدرها: شامل توکن Bearer احراز هویت است.

* ورودی: از خروجی "Task Succeeded" نود Switch.

* خروجی: داده‌های باینری فایل رسانه‌ای ناشناس شده.

* موارد مرزی: شکست دانلود به دلیل مشکلات شبکه، URLهای منقضی شده، یا مشکلات احراز هویت.

* Sticky Note (دستورالعمل دریافت نتیجه):

* به کاربر اطلاع می‌دهد که داده‌های خروجی حاوی فایل نهایی ناشناس شده است.

* کاربر را به بخش خروجی برای مشاهده یا دانلود فایل راهنمایی می‌کند.

* Sticky Note (پیش‌نمایش خروجی تصویر):

* نمونه‌ای از خروجی ناشناس شده مورد انتظار را نشان می‌دهد.

---

جدول خلاصه