ใช้ x-callback-url กับคำสั่งลัดบน iPhone หรือ iPad
แอปคำสั่งลัดรองรับ x-callback-url ซึ่งทำให้แอปที่เรียกได้รับการตอบสนอง (การตอบกลับ) เมื่อดำเนินการโต้ตอบบางอย่างเสร็จสมบูรณ์ คุณสามารถสั่งทำงานคำสั่งลัดจาก x-callback-url ได้โดยใช้พารามิเตอร์เดียวกันกับที่กล่าวถึงในสั่งทำงานคำสั่งลัดโดยใช้แบบแผน URL บน iPhone หรือ iPad ตัวอย่าง:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&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 อื่นเพื่อจัดการปัญหาได้