---
title: "وب‌هوک"
description: "وب‌هوک چیست، چه فرقی با پرسیدن دوره‌ای از API دارد، کدام رویدادهای حسابداری در حسابدار من وب‌هوک می‌فرستند و امضای HMAC SHA-256 را چطور بررسی کنیم."
canonical: https://hesabdar.my/glossary/webhook
language: fa
publisher: "حسابدار من"
updated: 2026-11-06
---

# وب‌هوک

> وب‌هوک چیست، چه فرقی با پرسیدن دوره‌ای از API دارد، کدام رویدادهای حسابداری در حسابدار من وب‌هوک می‌فرستند و امضای HMAC SHA-256 را چطور بررسی کنیم.

وب‌هوک درخواست HTTP است که یک سیستم هنگام وقوع رویدادی مشخص، مثلاً قطعی شدن یک سند حسابداری، خودکار به نشانی دلخواه شما می‌فرستد. به‌جای اینکه برنامه شما هر چند دقیقه از سیستم حسابداری بپرسد چیزی تغییر کرده یا نه، سیستم حسابداری همان لحظه خبر می‌دهد.

نشانی گیرنده و رویدادهای مورد نظر را ثبت می‌کنید. با وقوع رویداد، فرستنده یک بسته 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 حسابداری](https://hesabdar.my/guides/accounting-api) نمونه کد بررسی امضا را دارد.

## مثال: انتقال اسناد قطعی به انبار داده گزارش‌گیری

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

### فرق وب‌هوک با API چیست؟

در API سیستم شما هر وقت لازم داشت داده را درخواست می‌کند. در وب‌هوک سیستم دیگر با وقوع رویداد داده را برای شما می‌فرستد. بیشتر اتصال‌ها از هر دو استفاده می‌کنند: وب‌هوک برای اطلاع و API برای گرفتن جزئیات یا ثبت.

### اگر گیرنده من از دسترس خارج باشد چه می‌شود؟

ارسال ناموفق می‌شود و به سیاست تلاش دوباره فرستنده بستگی دارد. گیرنده را تکرارپذیر بسازید و پس از قطعی، از طریق API تطبیق دهید تا رویدادی جا نماند.

راهنما: https://hesabdar.my/guides/accounting-api