وبهوکها و اعلان در Slack، Microsoft Teams یا Discord
در Pro و Team، داشبورد > یکپارچهسازیها را باز کنید تا رویدادهای Pandafile را به یک کانال Slack، Microsoft Teams یا Discord یا بهصورت وبهوک امضاشده به سرور خودتان بفرستید. رویدادها را انتخاب کنید، یک آزمایش بفرستید و گزارش تحویل را ببینید.
در Pro و Team، Pandafile میتواند همان لحظه که اتفاقی میافتد به ابزارهای دیگرتان خبر بدهد: پیامی در یک کانال Slack، Microsoft Teams یا Discord، یا یک وبهوک، یعنی یک درخواست HTTPS امضاشده به سرور خودتان.
رویدادهایی که میتوانید انتخاب کنید
- انتقال آماده است: آپلود تمام شده و لینک کار میکند.
- انتقال دانلود شد: برای هر گیرنده یک بار، دفعهٔ اول. میتوانید بهجای آن هر دانلود را انتخاب کنید.
- انتقال منقضی شد.
- تأیید یا درخواست تغییر از طرف یک گیرنده.
- آپلود در یکی از درخواستهای فایل شما.
- سند را همه امضا کردند، برای Pandafile Sign.
یک یکپارچهسازی اضافه کنید
- در Slack، Microsoft Teams یا Discord برای کانال یک incoming webhook بسازید و URL آن را کپی کنید. برای سیستم خودتان از یک آدرس HTTPS روی سرورتان استفاده کنید.
- وارد Pandafile شوید و داشبورد > یکپارچهسازیها را باز کنید.
- زیر «افزودن یکپارچهسازی» نوع را انتخاب کنید، URL را بچسبانید، اگر خواستید نامی بگذارید و رویدادهای مورد نظر را تیک بزنید.
- دکمهٔ «افزودن یکپارچهسازی» و بعد «ارسال رویداد آزمایشی» را بزنید تا مطمئن شوید میرسد.
حداکثر 5 یکپارچهسازی میتوانید داشته باشید. پیامهای چت به زبان حسابتان نوشته میشوند.
وبهوکها برای توسعهدهندگان
- هر تحویل یک POST با JSON است که نوع رویداد، یک id و جزئیات را دارد: idها، عنوانها، لینکها، شمارشها و آدرس ایمیل گیرندهها. هرگز محتوای فایل، رمز عبور یا لینک دانلود شخصی در آن نیست.
- هر درخواست یک هدر Pandafile-Signature دارد با یک برچسب زمانی (t) و یک امضای HMAC-SHA256 (v1) از برچسب زمانی و بدنه که با کلید امضای شما ساخته شده است. کلید امضا با whsec_ شروع میشود و فقط یک بار نمایش داده میشود.
- «کلید جدید» یک کلید امضای تازه میسازد. کلید قبلی تا 24 ساعت کار میکند، تا بتوانید بدون از دست دادن رویدادها جابهجا شوید.
- ظرف 10 ثانیه با وضعیت 2xx پاسخ دهید. در غیر این صورت بعد از 1 دقیقه، 5 دقیقه، 30 دقیقه، 2 ساعت و 12 ساعت دوباره تلاش میکنیم.
- گزارش تحویل 50 تحویل آخر هر یکپارچهسازی و نتیجهشان را نشان میدهد.
تیمها، حالت آزمایشی و Zapier
در یک تیم، هر کس یکپارچهسازیهای خودش را مدیریت میکند و فقط رویدادهای انتقالهای خودش را میگیرد. رویدادهای انتقالهای آزمایشی که با کلید API آزمایشی ساخته شدهاند با livemode برابر false به وبهوکها میروند و هرگز به Slack، Teams یا Discord نمیروند. Zapier و Make از طریق API Pandafile وصل میشوند و زیر «اشتراکهای API» نمایش داده میشوند.