حمولات خطافات الويب (Webhooks) لطبقات المعالم

عند تكوين خطافات الويب لطبقات المعالم المستضافة، أو العروض المستضافة لطبقات المعالم، أو الجداول المستضافة، يتم إرسال حمولة من المعلومات إلى مستقبِل خطاف الويب عند حدوث تشغيل حدث. وتكون الحمولة عبارة عن طلب HTTPS POST يُرسل بتنسيق مخطط JSON.

يصف الجدول أدناه الخصائص المضمّنة في الحمولات الخاصة بخطافات الويب التي تقوم بإنشائها على طبقات المعالم المستضافة، أو العروض المستضافة لطبقات المعالم، أو الجداول المستضافة. تتضمن هذه الحمولات معلومات عن التغييرات التي تمت على خدمة المعالم المصدرية للطبقة أو الجدول.

الخاصيةالوصف
name

اسم خطاف الويب.

layerId

معرّف خطاف الويب الذي وصَّلَ الحمولة.

orgId

معرّف المؤسسة ArcGIS Online التي يُخزن فيها خطاف الويب.

serviceName

اسم خدمة المعالم التي تدعم طبقة المعالم أو الجدول. تم تعريف الاسم عند نشر طبقة الويب.

lastUpdatedTime

الطابع الزمني (معبرًا عنه بالمللي ثانية خلال مرحلة زمنية) لوقت وقوع الحدث.

changesUrl

عنوان URL لنقطة النهاية Extract Changes الخاصة بخدمة المعالم المصدرية للعنصر. يمكنك الوصول إلى عنوان URL هذا لمعرفة المزيد عن التغييرات المحددة التي حدثت أثناء الحدث.

events

نوع الحدث الذي تم تنفيذه. تُدرج القيم في قسم مشغلات أحداث طبقة المعالم.

يوضح المثال التالي حمولة نموذجية لخطاف ويب يتم تشغيله عندما يقوم أي شخص بإنشاء معلم أو صف (FeaturesCreated)، أو تحديث معلم أو صف (FeaturesUpdated)، أو حذف معلم أو صف (FeaturesDeleted) من طبقة في طبقة معالم مستضافة أو جدول مستضاف:

payload=[
          {
            "name":"webhook11",
            "layerId":0,
            "orgId":"ABCD1EFghIJK2LmN",
            "serviceName":"myservice",
            "lastUpdatedTime":1755719255181,
            "changesUrl":"https%3a%2f%2fservices2.arcgis.com%ABCD1EFghIJK2LmN%2fArcGIS%2frest%2fservices%2fmyservice%2fFeatureServer%2fextractChanges%3fserverGens%3d%5b762039%2c762044%5d%26async%3dtrue%26returnAttachments%3dfalse",
            "events":["FeaturesCreated","FeaturesUpdated","FeaturesDeleted"]
          }
         ]