![](https://cdn.statically.io/img/help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D258BE0233D28263F5A/ar_EG/389e356d55e928d40def9c16d476e5e0.png)
استخدام x-callback-url مع الاختصارات على iPhone أو iPad
يدعم تطبيق الاختصارات x-callback-url، والذي يسمح لتطبيق الاتصال باستلام رد (رد اتصال) عند اكتمال تفاعل معين. يمكنك تشغيل الاختصارات من x-callback-url باستخدام المعاملات ذاتها الموضحة في تشغيل اختصار باستخدام نظام URL على iPhone أو iPad. على سبيل المثال:
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 مختلف لمعالجة المشكلة.