وب‌هوک

نشانی گیرنده و رویدادهای مورد نظر را ثبت می‌کنید. با وقوع رویداد، فرستنده یک بسته JSON با شرح رویداد به نشانی شما POST می‌کند. گیرنده باید سریع با وضعیت ۲xx پاسخ دهد و کار سنگین را در پس‌زمینه انجام دهد.

حسابدار من برای رویدادهایی مثل entry.posted، stock_document.posted، stock_document.cancelled، production_order.closed و costing.run_posted وب‌هوک می‌فرستد و هر ارسال را با HMAC SHA-256 در سرآیند X-Webhook-Signature امضا می‌کند. پیش از اعتماد به محتوا، HMAC متن خام درخواست را با رمز وب‌هوک حساب کنید و با زمان ثابت مقایسه کنید.

گیرنده را طوری بسازید که ارسال تکراری یا جابه‌جا را تحمل کند: شناسه رویداد را ذخیره کنید و رویدادی را که قبلاً پردازش کرده‌اید نادیده بگیرید. راهنمای API حسابداری نمونه کد بررسی امضا را دارد.

یک گروه شرکت می‌خواهد همه اسناد قطعی در انبار داده گزارش‌هایش باشد. نشانی گیرنده را برای entry.posted ثبت می‌کند. وقتی حسابدار سند ۱۲۰۷ را قطعی می‌کند، گیرنده ظرف چند ثانیه بسته را دریافت، امضا را بررسی، ردیف‌ها را ذخیره و با ۲۰۰ پاسخ می‌دهد.