webhook یعنی چه؟
تلفظ: وِبهوک · نوع: اسم
معنی webhook: نشانیای که سرویس دیگر هنگام یک اتفاق خودش صدا میزند
hook یعنی قلاب. در حالت عادی تو از API میپرسی «خبر تازهای هست؟» و باید مدام بپرسی. webhook برعکس است: یک نشانی از سرور خودت را به آن سرویس میدهی و میگویی «هر وقت فلان اتفاق افتاد، خودت به این نشانی خبر بده». مثل این که بهجای هر ساعت زنگ زدن به پست، شمارهات را بدهی تا وقتی بسته رسید خودشان زنگ بزنند. مثلاً درگاه پرداخت وقتی پول واریز شد یک POST به webhook تو میفرستد، یا ربات پیامرسان هر پیام تازه را همینطور از سرور پیامرسان میگیرد.
webhook در جمله
Set up a webhook to get a message when a payment succeeds.
یک وبهوک راه بینداز تا وقتی پرداخت موفق شد پیام بگیری.
webhook در کد
@app.post("/webhook")
def on_event():
data = request.get_json()
print("New event:", data["type"])
return "", 200وبهوک از دید تو یک اندپوینت ساده است؛ فقط این بار سرویس دیگر آن را صدا میزند.
نکته
به کار قبلی، یعنی مدام پرسیدن، polling میگویند. به webhook گاهی «API برعکس» هم میگویند.
کلمههای مرتبط
- callback: تابعی که میدهی تا بعداً صدایش بزنند
- endpoint: نشانی یک کار مشخص در API
- event: رویداد؛ اتفاقی که برنامه از آن باخبر میشود
درس این کلمه
webhook یکی از هشت کلمهی درس «کلید و محدودیت» در فاز 4: وب و API از دورهی انگلیسی برای برنامهنویسها است. بقیهی کلمههای این درس:
- API key: کلید API؛ رمزی که برنامهی تو را به سرویس میشناساند
- secret: راز؛ هر مقدار محرمانه مثل رمز و کلید
- rate limit: سقف تعداد درخواست در یک بازهی زمانی
- quota: سهمیه؛ مقدار کل مجاز در یک دوره
- callback: تابعی که میدهی تا بعداً صدایش بزنند
- SDK: بستهی آمادهی ابزار و کد برای کار با یک سرویس
- sandbox: محیط آزمایشی و جدا، بدون خطر برای چیزهای واقعی