استخدام x-callback-url مع الاختصارات على iPhone أو iPad
يدعم تطبيق الاختصارات x-callback-url، والذي يسمح لتطبيق الاتصال باستلام رد (رد اتصال) عند اكتمال تفاعل معين. يمكنك تشغيل الاختصارات من x-callback-url باستخدام المعاملات ذاتها الموضحة في تشغيل اختصار باستخدام نظام URL على iPhone أو iPad. على سبيل المثال:
shortcuts://x-callback-url/run-shortcut?name=حساب البقشيش&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 مختلف لمعالجة المشكلة.