![](https://help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D248BE0233D28263F53/ar_EG/fbd8d40651fff19a46e7aaedd4cb1b09.png)
استخدام x-callback-url مع الاختصارات على Mac
يدعم تطبيق الاختصارات x-callback-url، والذي يسمح لتطبيق الاتصال باستلام رد (رد اتصال) عند اكتمال تفاعل معين. يمكنك تشغيل الاختصارات من x-callback-url باستخدام نفس المعاملات الموضحة في تشغيل اختصار باستخدام مخطط URL على Mac. على سبيل المثال:
shortcuts://x-callback-url/run-shortcut?name=حساب%20البقشيش&input=text&text=24.99&x-success=...&x-cancel=...
وفقًا لمعيار x-callback-url، يمكن توفير المعاملات الإضافية التالية:
x-success (اختياري): عنوان URL الذي يفتح عندما ينجح التفاعل—على سبيل المثال، بعد استيراد الاختصار أو الانتهاء من تشغيله. عند تشغيل الاختصار، يتم إلحاق معامل اسمه
result
بعنوان URL يحتوي على الإخراج النصي للاختصار.x-cancel (اختياري): عنوان URL الذي يفتح عندما يتم إلغاء التفاعل بواسطة المستخدم.
x-error (اختياري): عنوان URL الذي يفتح عندما يفشل التفاعل بسبب حدوث خطأ. يتم إلحاق معامل اسمه
errorMessage
بعنوان URL يحتوي على وصف للخطأ.
من خلال معامل x-success
، يمكنك توفير URL يفتح بعد الانتهاء من تشغيل الاختصار بنجاح. ويمكن استخدام هذا إلى جانب قائمة اختيار متعددة الخطوات للمهام، حيث يتم فتح x-callback-url لتشغيل الاختصار والرجوع إلى القائمة والمتابعة إلى المهمة التالية عبر URL.
ومن خلال معامل x-cancel
، يمكنك توفير URL للطوارئ يفتح في حالة توقف الاختصار قبل الانتهاء من تشغيله. وبما أن الاختصار لم يكتمل، فلن يتوفر إخراج من الاختصار.
ومن خلال معامل x-error
، يمكنك توفير URL للطوارئ يفتح إذا واجه الاختصار خطأ ما أثناء تشغيله وفشل الانتهاء من تشغيله. في هذه الحالة، يمكنك إطلاق URL مختلف لمعالجة المشكلة.