{"id":204512,"date":"2025-05-29T09:39:32","date_gmt":"2025-05-29T01:39:32","guid":{"rendered":"https:\/\/server.hk\/cnblog\/204512\/"},"modified":"2025-05-29T09:39:32","modified_gmt":"2025-05-29T01:39:32","slug":"django-%e4%b8%ad%e7%9a%84-webhook%ef%bc%9a%e7%bb%bc%e5%90%88%e6%8c%87%e5%8d%97","status":"publish","type":"post","link":"https:\/\/server.hk\/cnblog\/204512\/","title":{"rendered":"Django \u4e2d\u7684 Webhook\uff1a\u7efc\u5408\u6307\u5357"},"content":{"rendered":"<p><b><\/b>     <\/p>\n<h1>Django \u4e2d\u7684 Webhook\uff1a\u7efc\u5408\u6307\u5357<\/h1>\n<p>\u5927\u5bb6\u597d\uff0c\u4eca\u5929\u672c\u4eba\u7ed9\u5927\u5bb6\u5e26\u6765\u6587\u7ae0<span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\">\u300aDjango \u4e2d\u7684 Webhook\uff1a\u7efc\u5408\u6307\u5357\u300b<\/span>\uff0c\u6587\u4e2d\u5185\u5bb9\u4e3b\u8981\u6d89\u53ca\u5230<span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\"><span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\"><\/span><\/span>\uff0c\u5982\u679c\u4f60\u5bf9<span style=\"color: #FF6600;, Helvetica, Arial, sans-serif;font-size: 14px;background-color: #FFFFFF\">\u6587\u7ae0<\/span>\u65b9\u9762\u7684\u77e5\u8bc6\u70b9\u611f\u5174\u8da3\uff0c\u90a3\u5c31\u8bf7\u5404\u4f4d\u670b\u53cb\u7ee7\u7eed\u770b\u4e0b\u53bb\u5427~\u5e0c\u671b\u80fd\u771f\u6b63\u5e2e\u5230\u4f60\u4eec\uff0c\u8c22\u8c22\uff01<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.17golang.com\/uploads\/20241109\/1731138164672f1274c97fd.jpg\" class=\"aligncenter\"><\/p>\n<p>webhooks \u662f\u521b\u5efa\u5b9e\u65f6\u4e8b\u4ef6\u9a71\u52a8\u5e94\u7528\u7a0b\u5e8f\u7684\u5f3a\u5927\u529f\u80fd\u3002\u5728 django \u751f\u6001\u7cfb\u7edf\u4e2d\uff0c\u5b83\u4eec\u4f7f\u5e94\u7528\u7a0b\u5e8f\u80fd\u591f\u8fd1\u4e4e\u5b9e\u65f6\u5730\u5bf9\u5916\u90e8\u4e8b\u4ef6\u505a\u51fa\u53cd\u5e94\uff0c\u8fd9\u4f7f\u5f97\u5b83\u4eec\u5bf9\u4e8e\u4e0e\u7b2c\u4e09\u65b9\u670d\u52a1\uff08\u4f8b\u5982\u652f\u4ed8\u7f51\u5173\u3001\u793e\u4ea4\u5a92\u4f53\u5e73\u53f0\u6216\u6570\u636e\u76d1\u63a7\u7cfb\u7edf\uff09\u7684\u96c6\u6210\u7279\u522b\u6709\u7528\u3002\u672c\u6307\u5357\u5c06\u4ecb\u7ecd webhook \u7684\u57fa\u7840\u77e5\u8bc6\u3001\u5728 django \u4e2d\u8bbe\u7f6e\u5b83\u4eec\u7684\u8fc7\u7a0b\uff0c\u4ee5\u53ca\u6784\u5efa\u5065\u58ee\u3001\u53ef\u6269\u5c55\u4e14\u5b89\u5168\u7684 webhook \u5904\u7406\u7cfb\u7edf\u7684\u6700\u4f73\u5b9e\u8df5\u3002<\/p>\n<p>webhooks \u662f http \u56de\u8c03\uff0c\u6bcf\u5f53\u7279\u5b9a\u4e8b\u4ef6\u53d1\u751f\u65f6\uff0c\u5b83\u5c31\u4f1a\u5c06\u6570\u636e\u53d1\u9001\u5230\u5916\u90e8 url\u3002\u4e0e\u60a8\u7684\u5e94\u7528\u7a0b\u5e8f\u8bf7\u6c42\u6570\u636e\u7684\u4f20\u7edf api \u4e0d\u540c\uff0cwebhooks \u5141\u8bb8\u5916\u90e8\u670d\u52a1\u6839\u636e\u67d0\u4e9b\u89e6\u53d1\u5668\u5c06\u6570\u636e\u201c\u63a8\u9001\u201d\u5230\u60a8\u7684\u5e94\u7528\u7a0b\u5e8f\u3002<\/p>\n<p>\u4f8b\u5982\uff0c\u5982\u679c\u60a8\u7684\u5e94\u7528\u7a0b\u5e8f\u4e0e\u652f\u4ed8\u5904\u7406\u5668\u96c6\u6210\uff0c\u5219\u6bcf\u6b21\u652f\u4ed8\u6210\u529f\u6216\u5931\u8d25\u65f6\uff0cwebhook \u53ef\u80fd\u4f1a\u901a\u77e5\u60a8\u3002\u4e8b\u4ef6\u6570\u636e\uff08\u901a\u5e38\u91c7\u7528 json \u683c\u5f0f\uff09\u4f5c\u4e3a post \u8bf7\u6c42\u53d1\u9001\u5230\u5e94\u7528\u7a0b\u5e8f\u4e2d\u7684\u6307\u5b9a\u7aef\u70b9\uff0c\u4f7f\u5176\u80fd\u591f\u6839\u636e\u9700\u8981\u5904\u7406\u6216\u5b58\u50a8\u4fe1\u606f\u3002<\/p>\n<p>webhooks \u63d0\u4f9b\u4e86\u53cd\u5e94\u5f0f\u548c\u4e8b\u4ef6\u9a71\u52a8\u7684\u6a21\u578b\u3002\u4ed6\u4eec\u7684\u4e3b\u8981\u4f18\u70b9\u5305\u62ec\uff1a<\/p>\n<ul>\n<li>\u5b9e\u65f6\u6570\u636e\u6d41\uff1a\u4e8b\u4ef6\u53d1\u751f\u540e\u7acb\u5373\u63a5\u6536\u66f4\u65b0\u3002<\/li>\n<li>\u51cf\u5c11\u8f6e\u8be2\uff1a\u65e0\u9700\u4e0d\u65ad\u68c0\u67e5\u66f4\u65b0\u3002<\/li>\n<li>\u7b80\u5355\u96c6\u6210\uff1a\u4e0e stripe\u3001github \u6216 slack \u7b49\u7b2c\u4e09\u65b9\u670d\u52a1\u8fde\u63a5\u3002<\/li>\n<li>\u53ef\u6269\u5c55\u6027\uff1a\u6709\u6548\u5904\u7406\u5927\u91cf\u4e8b\u4ef6\u548c\u54cd\u5e94 <\/li>\n<\/ul>\n<p>\u5728 django \u4e2d\u5b9e\u73b0 webhook \u6d89\u53ca\u521b\u5efa\u4e13\u7528\u89c6\u56fe\u6765\u63a5\u6536\u548c\u5904\u7406\u4f20\u5165\u7684 post \u8bf7\u6c42\u3002\u8ba9\u6211\u4eec\u5b8c\u6210\u8fd9\u4e9b\u6b65\u9aa4\u3002<\/p>\n<p>\u521b\u5efa\u4e13\u95e8\u7528\u4e8e\u5904\u7406 webhook \u8bf7\u6c42\u7684 url \u7aef\u70b9\u3002\u4f8b\u5982\uff0c\u5047\u8bbe\u6211\u4eec\u6b63\u5728\u4e3a\u652f\u4ed8\u670d\u52a1\u8bbe\u7f6e\u4e00\u4e2a webhook\uff0c\u8be5\u670d\u52a1\u4f1a\u5728\u4ea4\u6613\u5b8c\u6210\u65f6\u901a\u77e5\u6211\u4eec\u3002<\/p>\n<p>\u5728 urls.py \u4e2d\uff1a<\/p>\n<pre>from django.urls import path\nfrom . import views\n\nurlpatterns = [\n    path(\"webhook\/\", views.payment_webhook, name=\"payment_webhook\"),\n]\n<\/pre>\n<p>\u89c6\u56fe\u5904\u7406\u4f20\u5165\u7684\u8bf7\u6c42\u5e76\u5904\u7406\u63a5\u6536\u5230\u7684\u6570\u636e\u3002\u7531\u4e8e webhooks \u901a\u5e38\u53d1\u9001 json \u6709\u6548\u8d1f\u8f7d\uff0c\u56e0\u6b64\u6211\u4eec\u5c06\u9996\u5148\u89e3\u6790 json \u5e76\u6839\u636e\u6709\u6548\u8d1f\u8f7d\u7684\u5185\u5bb9\u6267\u884c\u5fc5\u8981\u7684\u64cd\u4f5c\u3002<br \/> \u5728views.py\u4e2d\uff1a<\/p>\n<pre>import json\nfrom django.http import jsonresponse, httpresponsebadrequest\nfrom django.views.decorators.csrf import csrf_exempt\n\n@csrf_exempt  # exempt this view from csrf protection\ndef payment_webhook(request):\n    if request.method != \"post\":\n        return httpresponsebadrequest(\"invalid request method.\")\n\n    try:\n        data = json.loads(request.body)\n    except json.jsondecodeerror:\n        return httpresponsebadrequest(\"invalid json payload.\")\n\n    # perform different actions based on the event type\n    event_type = data.get(\"event_type\")\n\n    if event_type == \"payment_success\":\n        handle_payment_success(data)\n    elif event_type == \"payment_failure\":\n        handle_payment_failure(data)\n    else:\n        return httpresponsebadrequest(\"unhandled event type.\")\n\n    # acknowledge receipt of the webhook\n    return jsonresponse({\"status\": \"success\"})\n\n<\/pre>\n<p>\u4e3a\u4e86\u4fdd\u6301\u89c6\u56fe\u7684\u7b80\u6d01\u548c\u6a21\u5757\u5316\uff0c\u6700\u597d\u521b\u5efa\u5355\u72ec\u7684\u51fd\u6570\u6765\u5904\u7406\u6bcf\u4e2a\u7279\u5b9a\u7684\u4e8b\u4ef6\u7c7b\u578b\u3002<\/p>\n<pre>def handle_payment_success(data):\n    # extract payment details and update your models or perform required actions\n    transaction_id = data[\"transaction_id\"]\n    amount = data[\"amount\"]\n    # logic to update the database or notify the user\n    print(f\"payment succeeded with id: {transaction_id} for amount: {amount}\")\n\ndef handle_payment_failure(data):\n    # handle payment failure logic\n    transaction_id = data[\"transaction_id\"]\n    reason = data[\"failure_reason\"]\n    # logic to update the database or notify the user\n    print(f\"payment failed with id: {transaction_id}. reason: {reason}\")\n<\/pre>\n<p>\u8bbe\u7f6e\u7aef\u70b9\u540e\uff0c\u5728\u60a8\u8981\u96c6\u6210\u7684\u7b2c\u4e09\u65b9\u670d\u52a1\u4e2d\u914d\u7f6e webhook url\u3002\u901a\u5e38\uff0c\u60a8\u4f1a\u5728\u670d\u52a1\u7684\u4eea\u8868\u677f\u4e2d\u627e\u5230 webhook \u914d\u7f6e\u9009\u9879\u3002\u7b2c\u4e09\u65b9\u670d\u52a1\u8fd8\u53ef\u80fd\u63d0\u4f9b\u9009\u9879\u6765\u6307\u5b9a\u54ea\u4e9b\u4e8b\u4ef6\u5e94\u89e6\u53d1 webhook\u3002<\/p>\n<p>\u7531\u4e8e webhooks \u5411\u5916\u90e8\u6570\u636e\u5f00\u653e\u60a8\u7684\u5e94\u7528\u7a0b\u5e8f\uff0c\u56e0\u6b64\u9075\u5faa\u5b89\u5168\u6700\u4f73\u5b9e\u8df5\u5bf9\u4e8e\u9632\u6b62\u8bef\u7528\u6216\u6570\u636e\u6cc4\u9732\u81f3\u5173\u91cd\u8981\u3002<\/p>\n<ul>\n<li>\u4f7f\u7528\u8eab\u4efd\u9a8c\u8bc1\u4ee4\u724c\uff1a\u5305\u542b\u5171\u4eab\u5bc6\u94a5\u6216\u4ee4\u724c\u6765\u9a8c\u8bc1\u4f20\u5165\u8bf7\u6c42\u3002\u8bb8\u591a\u670d\u52a1\u5728\u8bf7\u6c42\u6807\u5934\u4e2d\u63d0\u4f9b\u4e86\u60a8\u53ef\u4ee5\u9a8c\u8bc1\u7684\u7b7e\u540d\u3002 <\/li>\n<\/ul>\n<pre>import hmac\nimport hashlib\n\ndef verify_signature(request):\n    secret = \"your_shared_secret\"\n    signature = request.headers.get(\"x-signature\")\n    payload = request.body\n\n    computed_signature = hmac.new(\n        secret.encode(),\n        payload,\n        hashlib.sha256\n    ).hexdigest()\n\n    return hmac.compare_digest(computed_signature, signature)\n\n<\/pre>\n<ul>\n<li>\u901f\u7387\u9650\u5236 webhooks\uff1a\u901a\u8fc7\u9650\u5236\u7aef\u70b9\u5728\u4e00\u6bb5\u65f6\u95f4\u5185\u53ef\u4ee5\u5904\u7406\u7684\u8bf7\u6c42\u6570\u91cf\u6765\u9632\u6b62\u6ee5\u7528\u3002<\/li>\n<li>\u5feb\u901f\u54cd\u5e94\uff1awebhooks \u901a\u5e38\u9700\u8981\u5feb\u901f\u54cd\u5e94\u3002\u907f\u514d\u5728\u89c6\u56fe\u4e2d\u8fdb\u884c\u590d\u6742\u7684\u540c\u6b65\u5904\u7406\u4ee5\u9632\u6b62\u8d85\u65f6\u3002<\/li>\n<li>\u7528\u4e8e\u7e41\u91cd\u5904\u7406\u7684\u961f\u5217\u4efb\u52a1\uff1a\u5982\u679c webhook \u5904\u7406\u6d89\u53ca\u957f\u65f6\u95f4\u8fd0\u884c\u7684\u4efb\u52a1\uff0c\u8bf7\u4f7f\u7528\u50cf celery \u8fd9\u6837\u7684\u4efb\u52a1\u961f\u5217\u6765\u5f02\u6b65\u5904\u7406\u5b83\u4eec\u3002 <\/li>\n<\/ul>\n<pre># example of celery task usage\nfrom .tasks import process_payment_event\n\n@csrf_exempt\ndef payment_webhook(request):\n    if request.method == \"post\":\n        data = json.loads(request.body)\n        process_payment_event.delay(data)  # queue the task for async processing\n        return jsonresponse({\"status\": \"accepted\"})\n    return httpresponsebadrequest(\"invalid request method.\")\n\n<\/pre>\n<p>\u6d4b\u8bd5 webhooks \u53ef\u80fd\u5177\u6709\u6311\u6218\u6027\uff0c\u56e0\u4e3a\u5b83\u4eec\u9700\u8981\u5916\u90e8\u670d\u52a1\u6765\u89e6\u53d1\u5b83\u4eec\u3002\u4ee5\u4e0b\u662f\u4e00\u4e9b\u5e38\u89c1\u7684\u6d4b\u8bd5\u65b9\u6cd5\uff1a<\/p>\n<ul>\n<li>\u4f7f\u7528\u50cf ngrok \u8fd9\u6837\u7684\u670d\u52a1\uff1angrok \u521b\u5efa\u4e00\u4e2a\u4e34\u65f6\u516c\u5171 url\uff0c\u5c06\u8bf7\u6c42\u8f6c\u53d1\u5230\u672c\u5730\u5f00\u53d1\u670d\u52a1\u5668\uff0c\u5141\u8bb8\u7b2c\u4e09\u65b9\u670d\u52a1\u5411\u5176\u53d1\u9001 webhooks\u3002<\/li>\n<li>\u6a21\u62df\u8bf7\u6c42\uff1a\u4ece\u6d4b\u8bd5\u811a\u672c\u6216django\u7684manage.py shell\u624b\u52a8\u89e6\u53d1\u5bf9webhook\u7aef\u70b9\u7684\u8bf7\u6c42\u3002<\/li>\n<li>django \u7684\u6d4b\u8bd5\u5ba2\u6237\u7aef\uff1a\u901a\u8fc7\u6a21\u62df post \u8bf7\u6c42\u4e3a webhook \u89c6\u56fe\u7f16\u5199\u5355\u5143\u6d4b\u8bd5\u3002 <\/li>\n<\/ul>\n<pre>from django.test import TestCase, Client\nimport json\n\nclass WebhookTest(TestCase):\n    def setUp(self):\n        self.client = Client()\n\n    def test_payment_success_webhook(self):\n        payload = {\n            \"event_type\": \"payment_success\",\n            \"transaction_id\": \"12345\",\n            \"amount\": 100\n        }\n        response = self.client.post(\n            \"\/webhook\/\",\n            data=json.dumps(payload),\n            content_type=\"application\/json\"\n        )\n        self.assertEqual(response.status_code, 200)\n        self.assertEqual(response.json(), {\"status\": \"success\"})\n\n<\/pre>\n<p>webhook \u662f\u521b\u5efa\u5b9e\u65f6\u4e8b\u4ef6\u9a71\u52a8\u5e94\u7528\u7a0b\u5e8f\u7684\u91cd\u8981\u7ec4\u6210\u90e8\u5206\uff0cdjango \u63d0\u4f9b\u4e86\u5b89\u5168\u6709\u6548\u5730\u5b9e\u73b0\u5b83\u4eec\u6240\u9700\u7684\u7075\u6d3b\u6027\u548c\u5de5\u5177\u3002\u901a\u8fc7\u9075\u5faa\u8bbe\u8ba1\u3001\u6a21\u5757\u5316\u548c\u5b89\u5168\u6027\u65b9\u9762\u7684\u6700\u4f73\u5b9e\u8df5\uff0c\u60a8\u53ef\u4ee5\u6784\u5efa\u53ef\u6269\u5c55\u3001\u53ef\u9760\u4e14\u6709\u5f39\u6027\u7684 webhook \u5904\u7406\u3002<\/p>\n<p>\u65e0\u8bba\u662f\u4e0e\u652f\u4ed8\u5904\u7406\u5668\u3001\u793e\u4ea4\u5a92\u4f53\u5e73\u53f0\u8fd8\u662f\u4efb\u4f55\u5916\u90e8 api \u96c6\u6210\uff0cdjango \u4e2d\u5b9e\u65bd\u826f\u597d\u7684 webhook \u7cfb\u7edf\u90fd\u53ef\u4ee5\u663e\u7740\u589e\u5f3a\u5e94\u7528\u7a0b\u5e8f\u7684\u54cd\u5e94\u80fd\u529b\u548c\u8fde\u63a5\u6027\u3002<\/p>\n<p>\u4eca\u5929\u5173\u4e8e\u300aDjango \u4e2d\u7684 Webhook\uff1a\u7efc\u5408\u6307\u5357\u300b\u7684\u5185\u5bb9\u5c31\u4ecb\u7ecd\u5230\u8fd9\u91cc\u4e86\uff0c\u662f\u4e0d\u662f\u5b66\u8d77\u6765\u4e00\u76ee\u4e86\u7136\uff01\u60f3\u8981\u4e86\u89e3\u66f4\u591a\u5173\u4e8e\u7684\u5185\u5bb9\u8bf7\u5173\u6ce8\u516c\u4f17\u53f7\uff01<\/p>\n<p>      \u7248\u672c\u58f0\u660e \u672c\u6587\u8f6c\u8f7d\u4e8e\uff1adev.to \u5982\u6709\u4fb5\u72af\uff0c\u8bf7\u8054\u7cfb\u5220\u9664<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Django \u4e2d\u7684 Webhoo&#46;&#46;&#46;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4925],"tags":[],"class_list":["post-204512","post","type-post","status-publish","format-standard","hentry","category-4925"],"_links":{"self":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts\/204512","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/comments?post=204512"}],"version-history":[{"count":0,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/posts\/204512\/revisions"}],"wp:attachment":[{"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/media?parent=204512"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/categories?post=204512"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/server.hk\/cnblog\/wp-json\/wp\/v2\/tags?post=204512"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}