توسعه‌دهندگان

وبهوک‌ها

هر اعلانی که حساب شما ایجاد می‌کند، می‌تواند مستقیماً به‌صورت یک JSON POST امضاشده به سیستم‌های خودتان ارسال شود — بنابراین هر آنچه در میزبانی شما رخ می‌دهد، می‌تواند یک جریان کاری را در هر جای دیگری آغاز کند.

تمام اسناد توسعه‌دهنده →

آنچه می‌توانید به آن متصل کنید

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

پلتفرم‌های اتوماسیون

یک وب‌هوک را به یک گردش کار در n8n, Make, Zapier, Pipedream, Activepieces هدایت کنید تا هر رویداد به یک محرک تبدیل شود — در یک کانال پست بگذارید، یک تیکت باز کنید، یک صفحه‌گسترده را به‌روزرسانی کنید، یک API دیگر را فراخوانی کنید. پلتفرم‌های خودمیزبان نیز دقیقاً به همین صورت عمل می‌کنند، به شرطی که نقطه پایانی از طریق HTTPS قابل دسترسی باشد.

سیستم‌های مدیریت ارتباط با مشتری و میزهای پشتیبانی

رویدادهای صورت‌حساب و حساب کاربری را به HubSpot, Pipedrive, Salesforce، یا به هر مرکز پشتیبانی یا CRM مجهز به وب‌هوک ورودی ارسال کنید تا پرونده مشتری، بدون نیاز به کپی کردن اطلاعات توسط فردی دیگر، نشان‌دهنده وضعیت هاستینگ او باشد.

هر چیز دیگری که گوش می‌دهد

Slack, Discord, Google Sheets, Airtable, Notion، مانیتورینگ خودتان، یک انبار داده، یا یک اسکریپت کوچک که نوشته‌اید. اگر بتواند یک HTTPS POST را بپذیرد و JSON را بخواند، می‌تواند این موارد را دریافت کند.

آنچه ارسال می‌شود

شما انتخاب می‌کنید که کدام دسته‌ها به کدام مقصد بروند — و می‌توانید چندین مقصد را متصل کنید تا صورت‌حساب‌ها به یک جا و هشدارهای سایت به جای دیگری بروند. همه چیز به طور پیش‌فرض فعال است.

صورتحساب و پرداخت‌ها

فاکتورهای صادرشده و پرداخت‌شده، پرداخت‌های ناموفق، کارت‌های در آستانه انقضا، تمدیدها و لغوها.

سایت‌ها و امنیت

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

پشتیبانی و دامنه‌ها

تیکت‌های باز شده و ارجاع داده شده، انتقال دامنه‌ها، تمدیدها و تغییرات DNS.

اثبات این‌که یک درخواست از طرف ما ارسال شده است

هر درخواست با رمزی امضا می‌شود که فقط شما و ما در اختیار داریم. پیش از اقدام روی بدنه، امضا را بررسی کنید — این سرآیندها با هر تحویل ارسال می‌شوند:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

مُهر زمانی به‌جای اینکه در کنار بدنه ارسال شود، همراه با آن امضا می‌شود، بنابراین درخواستی که توسط شخصی ضبط شده است، بعداً نمی‌تواند دوباره علیه شما ارسال شود. هر موردی را که قدیمی‌تر از چند دقیقه است، رد کنید.

کلید مخفی امضای شما فقط یک بار، هنگام افزودن وبهوک نمایش داده می‌شود. ما نمی‌توانیم آن را دوباره نشان دهیم — اگر آن را گم کردید، مقصد را حذف کرده و مجدداً اضافه کنید.

در حال راه‌اندازی یکی

  1. در داشبورد خود، اعلان‌ها را باز کنید و یک مقصد از نوع Webhook اضافه نمایید.
  2. نقطه پایانی HTTPS خود را به آن بدهید و کلید مخفی امضایی را که به شما نشان می‌دهیم کپی کنید.
  3. روی Test فشار دهید. ما یک درخواست واقعی با همان ساختار درخواست زنده ارسال می‌کنیم تا بتوانید قبل از رخ دادن هر اتفاق واقعی، بر اساس آن ساختار خود را بسازید.
  4. دسته‌هایی را که آن مقصد باید دریافت کند، انتخاب کنید. انواع جدید اعلان‌ها به‌طور خودکار فعال می‌شوند.

می‌توانید هر تعداد مقصد که می‌خواهید اضافه کنید، وب‌هوک‌ها را با ایمیل، Slack و Telegram ترکیب کنید و به هر کدام مجموعه‌ای متفاوت از دسته‌ها اختصاص دهید.

آیا ترجیح می‌دهید با ما تماس بگیرید؟

وبهوک‌ها زمان وقوع یک رویداد را به شما اطلاع می‌دهند. ای‌پی‌آی (API) روشی است که به واسطه آن رویدادی را ایجاد می‌کنید — تمام عملیاتی که داشبورد انجام می‌دهد در دسترس شماست.

مرور مستندات مرجع API