---
title: "Apache APISIX Serverless Plugin لأحداث Event Hooks - API7.ai"
description: "في هذه المقالة، سنغطي أساسيات Apache APISIX serverless plugin وكيف يمكن استخدامه لتنشيط وظائف serverless استجابةً للأحداث."
url: "https://api7.ai/ar/blog/serverless-plugin-for-event-hooks"
---

[Blog](https://api7.ai/ar/blog)

[Products](https://api7.ai/ar/category/products)[Technology](https://api7.ai/ar/category/technology)[Ecosystem](https://api7.ai/ar/category/ecosystem)[Case Study](https://api7.ai/ar/category/usercase)[Team & Community](https://api7.ai/ar/category/community)

Search

⌘ + K

[Blog](https://api7.ai/blog)

Technology

# Apache APISIX Serverless Plugin لأحداث Event Hooks

[![Bobur Umurzokov](https://avatars.githubusercontent.com/u/14247607)](https://www.linkedin.com/in/boburumurzokov/)

[Bobur Umurzokov](https://www.linkedin.com/in/boburumurzokov/)

February 15, 2023

[Technology](https://api7.ai/category/technology)

[Apache APISIX](https://apisix.apache.org/) هو بوابة [API](https://apisix.apache.org/docs/apisix/terminology/api-gateway/) مفتوحة المصدر وعالية الأداء مبنية على [Nginx](https://www.nginx.com/). واحدة من ميزاته القوية هي القدرة على إنشاء وظائف بدون خادم (serverless functions)، وهي برامج صغيرة وحالة لا تحتوي على حالة (stateless) يمكنها توسيع وظائف Apache APISIX. في هذه المقالة، سنغطي أساسيات [الإضافة](https://apisix.apache.org/docs/apisix/plugins/serverless/) **serverless** في Apache APISIX وكيف يمكن استخدامها لتنشيط **وظائف بدون خادم** استجابة للأحداث.

## أهداف التعلم

ستتعلم ما يلي خلال المقالة:

- ما هي إضافة Apache APISIX serverless؟
- كيف تعمل إضافة serverless وكيفية استخدامها؟
- حالات استخدام إضافة serverless.
- كيف يمكنك استخدام إضافة serverless للدمج مع [webhook](https://en.wikipedia.org/wiki/Webhook).

## ما هي إضافة Apache APISIX serverless؟

تسمح لك إضافة [serverless](https://apisix.apache.org/docs/apisix/plugins/serverless/) في Apache APISIX لربط الأحداث بكتابة وظائف بدون خادم ودمجها في بوابة API. توفر الإضافة طريقة بسيطة ومرنة لتشغيل التعليمات البرمجية المخصصة استجابة للأحداث، دون الحاجة إلى إدارة البنية التحتية الأساسية.

تفصل إضافة serverless منطق التعامل مع الأحداث إلى وظائف بدون خادم منفصلة، مما يمكنك من تبسيط بنية API الخاصة بك وجعلها أسهل في الإدارة. يوفر Apache APISIX دعمًا لأطر العمل بدون خادم لمزودي السحابة الشهيرة مثل [Azure Functions](https://azure.microsoft.com/en-in/services/functions/) و[AWS Lambda](https://aws.amazon.com/lambda/).

## كيفية استخدام إضافة serverless؟

لاستخدام إضافة Apache APISIX serverless لربط الأحداث، ستحتاج إلى كتابة كود وظيفة بدون خادم بلغة [Lua](https://www.lua.org/) التي تنفذ المنطق الذي تريد تشغيله استجابة لحدث وتمكين إضافة `serverless-pre-function` أو `serverless-post-function` اعتمادًا على مراحل دورة الطلب-الاستجابة التي تختارها.

> حاليًا، يدعم APISIX فقط Lua لكتابة كود الوظيفة. إذا كنت تفضل لغات برمجة أخرى، يمكنك دائمًا استخدام [مشغلات الإضافات](https://apisix.apache.org/docs/apisix/external-plugin/) لإنشاء [إضافة مخصصة](https://apisix.apache.org/docs/apisix/plugin-develop/) من الصفر.

## حالات استخدام إضافة serverless

فيما يلي بعض حالات استخدام إضافة Apache APISIX serverless لربط الأحداث:

1. **التوجيه الديناميكي**: يمكن استخدام إضافة serverless لتوجيه طلبات API الواردة بشكل ديناميكي بناءً على معايير محددة، مثل طريقة الطلب أو مسار URL أو قيم الرؤوس. هذا يسمح لك بتنفيذ سيناريوهات التوجيه المعقدة بسهولة دون الحاجة إلى تعديل تكوين Apache APISIX الأساسي.
2. **المصادقة والتفويض**: يمكنك استخدام إضافة serverless لتنفيذ عمليات التحقق من المصادقة والتفويض لـ API الخاصة بك. على سبيل المثال، يمكنك كتابة وظيفة بدون خادم تتحقق من وجود مفتاح API صالح في رؤوس الطلب قبل السماح للطلب بالاستمرار. أو يمكن استخدامها كخدمة تفويض خارجية مع دمج إضافة [forward-auth](https://apisix.apache.org/docs/apisix/plugins/forward-auth/).
3. **تحويل الطلب**: يمكن استخدام إضافة serverless لتحويل طلبات API الواردة قبل معالجتها بواسطة الخدمة الخلفية. على سبيل المثال، يمكنك كتابة وظيفة بدون خادم تعدل رؤوس الطلب أو الجسم لتتناسب مع التنسيق المتوقع من الخدمة الخلفية.
4. **تحويل الاستجابة**: يمكنك أيضًا استخدام إضافة serverless لتحويل الاستجابة من الخدمة الخلفية قبل إرسالها مرة أخرى إلى العميل. على سبيل المثال، يمكنك كتابة وظيفة بدون خادم تعدل رؤوس الاستجابة أو الجسم لتتناسب مع التنسيق المتوقع من العميل.
5. **التسجيل والمراقبة**: يمكنك استخدام إضافة serverless لتنفيذ عمليات التسجيل والمراقبة لـ API الخاصة بك. على سبيل المثال، يمكنك كتابة وظيفة بدون خادم تسجل معلومات مفصلة عن كل طلب API، مثل طريقة الطلب وURL والرؤوس والجسم، لتحليلها لاحقًا.

## دمج Apache APISIX مع webhooks (عرض توضيحي)

لدمج Apache APISIX مع webhooks، تحتاج إلى إنشاء وظيفة بدون خادم تستمع لطلبات POST الواردة إلى نقطة نهاية URL، وتتحقق مما إذا كانت طريقة الطلب هي POST، وترسل إشعار webhook إلى خدمة طرف ثالث كلما تم نشر رسالة جديدة.

يجب أن تعيد الوظيفة بدون خادم أيضًا الاستجابة من webhook، حتى تتمكن من رؤية حالة webhook وأي رسائل خطأ إذا حدث خطأ ما. في كلتا الحالتين، يمكن لـ APISIX التواصل مع الخدمة الهدف، وإعلامها بأن حدثًا تم تشغيله عن طريق استدعاء URL معين مع معلومات حول هذا الحدث.

![APISIX يرسل طلب POST إلى webhook](https://static.api7.ai/uploads/2023/02/15/3TLaxlOe_Serverless_webhook_for_the_route.png?imageMogr2/format/webp)

### المتطلبات الأساسية

- تثبيت [Docker](https://www.docker.com/products/docker-desktop/) على جهازك لتشغيل APISIX.
- معرفة أساسية ببعض مفاهيم APISIX الأساسية مثل [Route](https://apisix.apache.org/docs/apisix/terminology/route/) و[Upstream](https://apisix.apache.org/docs/apisix/terminology/upstream/) و[Plugin](https://apisix.apache.org/docs/apisix/terminology/plugin/).

### إعداد المشروع

أول شيء تقوم به هو استنساخ مشروع [apisix-docker](https://github.com/apache/apisix-docker) من [GitHub](https://github.com/):

```
git clone https://github.com/apache/apisix-docker.git
```

افتح مجلد المشروع في محرر الأكواد المفضل لديك. يستخدم هذا البرنامج التعليمي [VS Code](https://code.visualstudio.com/).

### تثبيت وتشغيل Apache APISIX

لتشغيل Apache APISIX، يمكنك اتباع هذه الخطوات:

افتح نافذة طرفية جديدة وقم بتشغيل الأمر `docker compose up` من المجلد الجذر للمشروع:

```
docker compose up -d
```

سيقوم الأمر أعلاه بتشغيل Apache APISIX وetcd معًا باستخدام Docker.

> قمنا بتثبيت APISIX باستخدام Docker في هذا العرض التوضيحي. ومع ذلك، هناك خيارات أخرى لتثبيته في [دليل التثبيت](https://apisix.apache.org/docs/apisix/installation-guide/).

### تكوين وظيفة بدون خادم في Apache APISIX

لإعداد وظيفة بدون خادم في Apache APISIX، تحتاج إلى إنشاء [route](https://apisix.apache.org/docs/apisix/terminology/route/) جديد لنقطة النهاية وتكوين إضافة serverless مع كود الوظيفة المخصصة بلغة Lua.

فيما يلي مثال لوظيفة بدون خادم بلغة Lua تستمع لطلبات POST الواردة إلى نقطة النهاية وترسل إشعار webhook:

```
function webhook(conf, ctx)

    -- استيراد المكتبات الضرورية
    local http = require("resty.http")
    local core = require("apisix.core")

    -- إرسال إشعار webhook فقط إذا كانت طريقة الطلب POST، وإلا تخطي وإرساله إلى الخدمة الخلفية كالمعتاد
    if core.request.get_method() == "POST" then
        -- إرسال إشعار webhook إلى URL المحدد
        local httpc = http.new()
        local res, err = httpc:request_uri("http://webhook.site/9db3d3a0-ab64-4142-a39f-d4852ca50f8d", {
            method = "POST",
            headers = {
                ["Content-Type"] = "application/json"
            },
            body = core.request.get_body(),
        })
        -- التحقق من الاستجابة من webhook
        if not res then
            core.log.error("Failed to send webhook: ", err)
            return 500, err
        end
    end

    -- إعادة الاستجابة من الخدمة الخلفية
    return conf.status, conf.body
end
```

كما ترى في كود الوظيفة أعلاه، يقوم بإرسال طلبات POST بتنسيق JSON إلى URL معين مع جسم الطلب (جسم الطلب من العميل إلى بوابة API) كحمولة. يتم استخدام موقع اختبار webhooks لمحاكاة نقطة نهاية webhook الخاصة بنا: [https://webhook.site](https://webhook.site/).

لإنشاء وتعيين نقطة نهاية webhook الخاصة بك:

1. قم بإنشاء URL عن طريق الانتقال إلى [https://webhook.site](https://webhook.site/) في متصفح الويب الخاص بك.
2. اختر **نسخ إلى الحافظة** بجوار **Your unique URL**.
3. الصقه في طريقة **request\_uri** لطلب HTTP في كود الوظيفة.

أيضًا، سيتم توجيه جميع الطلبات الأخرى بما في ذلك POST إلى الخدمة الخلفية. في الخطوة التالية، نقوم بتكوين route وupstream.

### تكوين Route وUpstream

الآن سنقوم بإنشاء route جديد مع تمكين إضافة serverless وupstream يعمل كخدمتنا الخلفية.

```
curl -X PUT 'http://127.0.0.1:9180/apisix/admin/routes/1' \
    -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' \
    -H 'Content-Type: application/json' \
    -d '{
    "uri": "/post",
    "plugins": {
        "serverless-pre-function": {
            "phase": "rewrite",
            "functions" : ["
                    return function(conf, ctx)
                        -- استيراد المكتبات الضرورية
                        local http = require(\"resty.http\")
                        local core = require(\"apisix.core\")

                        -- إرسال إشعار webhook فقط إذا كانت طريقة الطلب POST، وإلا تخطي وإرساله إلى الخدمة الخلفية كالمعتاد
                        if core.request.get_method() == \"POST\" then
                            -- إرسال إشعار webhook إلى URL المحدد
                            local httpc = http.new()
                            local res, err = httpc:request_uri(\"http://webhook.site/9db3d3a0-ab64-4142-a39f-d4852ca50f8d\", {
                                method = \"POST\",
                                headers = {
                                    [\"Content-Type\"] = \"application/json\"
                                },
                                body = core.request.get_body(),
                            })
                            -- التحقق من الاستجابة من webhook
                            if not res then
                                core.log.error(\"Failed to send webhook: \", err)
                                return 500, err
                            end
                        end

                        -- إعادة الاستجابة من الخدمة الخلفية
                        return conf.status, conf.body
                    end"]
        }
    },
    "upstream": {
        "nodes": {
            "httpbin.org:80": 1
        },
        "type": "roundrobin"
    }
}'
```

في مثال تكوين route السابق، قمنا بإنشاء أول route لدينا عن طريق إرسال طلب `curl` إلى [واجهة برمجة تطبيقات الإدارة](https://apisix.apache.org/docs/apisix/admin-api/) في APISIX. في جسم طلب Route، حددنا أن أي طلبات إلى المسار `/post` ستشغل كود الوظيفة بدون خادم وسيتم توجيهها لاحقًا إلى الهدف `httpbin.org`. هذا يعني أن الطلب سيتم توجيهه إلى نقطة النهاية `httpbin.org/post` بعد التحقق مما إذا كانت طريقة الطلب هي POST وما إذا كان يجب إرسال الحدث إلى نقطة نهاية webhook للخدمة الخارجية أم لا. يمكن استبدال الخدمة الخلفية بخدمتك الخلفية.

قد تلاحظ أيضًا أننا أضفنا كود الوظيفة إلى خاصية `functions` في `serverless-pre-function` في كائن Json.

### اختبار التكوين

أخيرًا، نقوم باختبار استدعاء نقطة نهاية `/post` في بوابة API لمعرفة ما إذا كان كل شيء يعمل كما هو متوقع وسيتم إرسال حدث POST إلى موقع webhook.

```
curl -i http://127.0.0.1:9080/post -X POST -d \
'{
   "message": "A new webhook message"
}'
```

بعد ذلك، انتقل إلى URL webhook من صفحة [https://webhook.site](https://webhook.site/) التي قمت بإنشائها في الخطوات السابقة. يجب أن ترى طلب POST، يخطر نقطة نهاية webhook الخاصة بنا حول الحدث ويرسل جسم الطلب.

![APISIX يرسل الحمولة إلى webhook](https://static.api7.ai/uploads/2023/02/12/Hy50dY6l_5abc9b3e4ow6o1j8ggp4.png?imageMogr2/format/webp)

بالإضافة إلى ذلك، نحصل على الاستجابة من الخدمة الخلفية الوهمية `httpbin.org`:

```
HTTP/1.1 200 OK
Content-Type: application/json

{
  ...
  "form": {
    "{\n   \"message\": \"A new webhook message\"\n}": ""
  },
  "headers": {
    "Accept": "*/*",
    "Content-Length": "41",
    "Content-Type": "application/x-www-form-urlencoded",
    "Host": "127.0.0.1",
    "X-Forwarded-Host": "127.0.0.1"
  },
  "json": null,
  "url": "http://127.0.0.1/post"
}
```

من الواضح أنه إذا قمت بإرسال طلبات HTTP بطرق أخرى غير POST، فلن يتم تشغيل كود الوظيفة بدون خادم لإرسال نقطة نهاية webhook.

هذا مثال أساسي لإعداد وظيفة بدون خادم في Apache APISIX. يمكنك توسيع هذه الوظيفة عن طريق إضافة منطق أكثر تعقيدًا إلى وظيفتك بدون خادم مثل تشغيل وظيفة أخرى استجابة لـ webhooks.

## الخلاصة

توفر إضافة Apache APISIX serverless لربط الأحداث طريقة مرنة وقابلة للتوسع لتنشيط وظائف بدون خادم استجابة للأحداث التي تحدث أثناء معالجة طلبات API. باستخدام الإضافة، يمكنك تبسيط بنية API الخاصة بك، وتحسين أداء وموثوقية خدماتك، وتقليل تكلفة إدارة بنية التطبيق الخاصة بك.

### موارد ذات صلة

- [واجهات برمجة التطبيقات المدفوعة بالأحداث مع Webhook وبوابة API](https://apisix.apache.org/blog/2022/11/07/webhook-api-gateway-event-driven-apis/)

### محتوى موصى به

- [إدارة واجهات برمجة التطبيقات بدون خادم باستخدام Apache APISIX](https://www.iambobur.com/post/manage-serverless-apis-with-apache-apisix)
- [كيفية اختيار بوابة API المناسبة](https://iambobur.com/2022/11/22/how-to-choose-the-right-api-gateway/)
- [لماذا تعتبر Apache APISIX أفضل بوابة API؟](https://api7.ai/blog/why-is-apache-apisix-the-best-api-gateway)

### المجتمع

🙋 [انضم إلى مجتمع Apache APISIX](https://apisix.apache.org/docs/general/join/) 🐦 [تابعنا على Twitter](https://twitter.com/ApacheAPISIX) 📝 [ابحث عننا على Slack](https://join.slack.com/t/the-asf/shared_invite/zt-vlfbf7ch-HkbNHiU_uDlcH_RvaHv9gQ)

Tags:

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[Plugin](https://api7.ai/tags/plugin)

Share article link

Share

Related Posts

[![كيفية تنفيذ تنسيق الإضافات (Plugin Orchestration) في بوابة واجهة برمجة التطبيقات (API Gateway)](https://static.api7.ai/2022/11/18/637726421d748.png)](https://api7.ai/blog/how-to-implement-plugin-orchestration-in-api-gateway)

## [كيفية تنفيذ تنسيق الإضافات (Plugin Orchestration) في بوابة واجهة برمجة التطبيقات (API Gateway)](https://api7.ai/blog/how-to-implement-plugin-orchestration-in-api-gateway)

[![بوابة API مقابل إدارة API](https://static.api7.ai/uploads/2024/12/25/zQTHfZGV_api-gateway-vs-api-management.jpg)](https://api7.ai/blog/api-gateway-and-api-management-comparison)

## [بوابة API مقابل إدارة API](https://api7.ai/blog/api-gateway-and-api-management-comparison)

Table of Contents

- [أهداف التعلم](#%D8%A3%D9%87%D8%AF%D8%A7%D9%81-%D8%A7%D9%84%D8%AA%D8%B9%D9%84%D9%85)

- [ما هي إضافة Apache APISIX serverless؟](#%D9%85%D8%A7-%D9%87%D9%8A-%D8%A5%D8%B6%D8%A7%D9%81%D8%A9-apache-apisix-serverless)

- [كيفية استخدام إضافة serverless؟](#%D9%83%D9%8A%D9%81%D9%8A%D8%A9-%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-%D8%A5%D8%B6%D8%A7%D9%81%D8%A9-serverless)

- [حالات استخدام إضافة serverless](#%D8%AD%D8%A7%D9%84%D8%A7%D8%AA-%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-%D8%A5%D8%B6%D8%A7%D9%81%D8%A9-serverless)

- [دمج Apache APISIX مع webhooks (عرض توضيحي)](#%D8%AF%D9%85%D8%AC-apache-apisix-%D9%85%D8%B9-webhooks-%D8%B9%D8%B1%D8%B6-%D8%AA%D9%88%D8%B6%D9%8A%D8%AD%D9%8A)

  - [المتطلبات الأساسية](#%D8%A7%D9%84%D9%85%D8%AA%D8%B7%D9%84%D8%A8%D8%A7%D8%AA-%D8%A7%D9%84%D8%A3%D8%B3%D8%A7%D8%B3%D9%8A%D8%A9)
  - [إعداد المشروع](#%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D9%85%D8%B4%D8%B1%D9%88%D8%B9)
  - [تثبيت وتشغيل Apache APISIX](#%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D9%88%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-apache-apisix)
  - [تكوين وظيفة بدون خادم في Apache APISIX](#%D8%AA%D9%83%D9%88%D9%8A%D9%86-%D9%88%D8%B8%D9%8A%D9%81%D8%A9-%D8%A8%D8%AF%D9%88%D9%86-%D8%AE%D8%A7%D8%AF%D9%85-%D9%81%D9%8A-apache-apisix)
  - [تكوين Route وUpstream](#%D8%AA%D9%83%D9%88%D9%8A%D9%86-route-%D9%88upstream)
  - [اختبار التكوين](#%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86)

- [الخلاصة](#%D8%A7%D9%84%D8%AE%D9%84%D8%A7%D8%B5%D8%A9)

  - [موارد ذات صلة](#%D9%85%D9%88%D8%A7%D8%B1%D8%AF-%D8%B0%D8%A7%D8%AA-%D8%B5%D9%84%D8%A9)
  - [محتوى موصى به](#%D9%85%D8%AD%D8%AA%D9%88%D9%89-%D9%85%D9%88%D8%B5%D9%89-%D8%A8%D9%87)
  - [المجتمع](#%D8%A7%D9%84%D9%85%D8%AC%D8%AA%D9%85%D8%B9)

## Related Posts

[![تطوير مكون إضافي مخصص لـ APISIX باستخدام Lua و ChatGPT](https://static.api7.ai/uploads/2024/12/25/MssMP69w_custom-plugin-development.png)](https://api7.ai/ar/blog/plugin-development-with-lua-and-chatgpt)

Technology

June 12, 2023

#### [تطوير مكون إضافي مخصص لـ APISIX باستخدام Lua و ChatGPT](https://api7.ai/ar/blog/plugin-development-with-lua-and-chatgpt)

سترشدك هذه المقالة خلال عملية تطوير مكون إضافي مخصص جديد يُسمى file-proxy لـ APISIX باستخدام Lua و ChatGPT.

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[Plugin](https://api7.ai/tags/plugin)

[!["inspect": مكون تصحيح Lua الديناميكي في Apache APISIX](https://static.api7.ai/uploads/2024/12/25/UCXbIJjU_lua-dynamic-debugging.png)](https://api7.ai/ar/blog/apisix-lua-dynamic-debugging-plugin)

Technology

January 29, 2023

#### ["inspect": مكون تصحيح Lua الديناميكي في Apache APISIX](https://api7.ai/ar/blog/apisix-lua-dynamic-debugging-plugin)

تعتبر إضافة inspect في Apache APISIX مفيدة في استكشاف الأخطاء وإصلاحها، وطباعة السجلات المحظورة، وتعلم كود Lua من خلال التصحيح.

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[Plugin](https://api7.ai/tags/plugin)

[![إدارة واجهات برمجة التطبيقات بدون خادم باستخدام Apache APISIX](https://static.api7.ai/uploads/2024/12/25/1HDjqo0V_manage-serverless-api-with-apisix.png)](https://api7.ai/ar/blog/manage-serverless-apis-with-apache-apisix)

Technology

January 18, 2023

#### [إدارة واجهات برمجة التطبيقات بدون خادم باستخدام Apache APISIX](https://api7.ai/ar/blog/manage-serverless-apis-with-apache-apisix)

تظهر هذه المقالة بمثال بسيط كيفية إدارة واجهات برمجة التطبيقات (APIs) الخالية من الخادم (serverless) المعتمدة على Java باستخدام Apache APISIX.

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[Plugin](https://api7.ai/tags/plugin)
