Sử dụng x-callback-url với Phím tắt trên iPhone hoặc iPad
Phím tắt hỗ trợ x-callback-url, cho phép ứng dụng gọi nhận được một phản hồi (gọi lại) khi một tương tác cụ thể đã hoàn tất. Bạn có thể chạy các phím tắt từ x-callback-url bằng cùng các tham số như đã thảo luận trong phần Chạy phím tắt bằng giao thức URL trên iPhone hoặc iPad. Ví dụ:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Theo tiêu chuẩn x-callback-url, các tham số bổ sung sau có thể được cung cấp:
x-success (tùy chọn): Một URL mở ra khi tương tác thành công – ví dụ: sau khi một phím tắt được nhập hoặc chạy xong. Nếu phím tắt được chạy, một tham số có tên
resultđược nối vào URL và chứa đầu ra nguyên bản của phím tắt.x-cancel (tùy chọn): Một URL mở ra khi tương tác bị người dùng hủy.
x-error (tùy chọn): Một URL mở ra khi tương tác không thành công vì đã xảy ra lỗi. Một tham số có tên
errorMessageđược nối vào URL và chứa mô tả lỗi.
Với x-success, bạn có thể cung cấp một URL mở ra sau khi phím tắt chạy xong thành công. Tham số này có thể được sử dụng kết hợp với danh sách kiểm tra nhiệm vụ nhiều bước, trong đó bạn mở x-callback-url để chạy phím tắt, quay lại danh sách và tiếp tục đến nhiệm vụ tiếp theo thông qua URL.
Với x-cancel, bạn có thể cung cấp một URL ngẫu nhiên sẽ khởi chạy nếu phím tắt dừng trước khi chạy xong. Vì phím tắt không hoàn thành, không có đầu ra nào từ phím tắt được cung cấp.
Với x-error, bạn có thể cung cấp một URL ngẫu nhiên sẽ khởi chạy nếu phím tắt gặp phải một lỗi trong khi chạy và không thể hoàn tất. Trong trường hợp này, bạn có thể bắt đầu một URL khác để xử lý sự cố.