Menggunakan x-callback-url dengan Pintasan di Mac
Pintasan mendukung x-callback-url, sehingga Anda dapat memanggil app untuk menerima respons (panggilan balik) setelah interaksi tertentu selesai. Anda dapat mengimpor dan menjalankan pintasan dari x-callback-url menggunakan parameter yang sama dengan yang dibahas di Menjalankan pintasan menggunakan skema URL di Mac. Misalnya:
shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-cancel=...
Sesuai dengan standar x-callback-url, parameter tambahan berikut dapat disediakan:
x-success (opsional): URL yang terbuka saat interaksi berhasil—misalnya, setelah pintasan diimpor atau selesai dijalankan. Jika pintasan dijalankan, parameter yang bernama
resultakan ditambahkan ke URL dan berisi output teks dari pintasan.x-cancel (opsional): URL yang terbuka saat interaksi dibatalkan oleh pengguna.
x-error (opsional): URL yang terbuka saat interaksi gagal karena terjadi kesalahan. Parameter bernama
errorMessageditambahkan ke URL dan berisi deskripsi kesalahan tersebut.
Dengan x-success, Anda dapat menyediakan URL yang terbuka setelah pintasan berhasil dijalankan hingga selesai. Ini dapat digunakan bersama daftar centang tugas dengan beberapa langkah, tempat Anda dapat membuka x-callback-url untuk menjalankan pintasan, kembali ke daftar, dan melanjutkan ke tugas berikutnya melalui URL.
Dengan x-cancel, Anda dapat menyediakan URL cadangan untuk diluncurkan jika pintasan berhenti sebelum selesai dijalankan. Karena pintasan tidak selesai, tidak ada output dari pintasan yang disediakan.
Dengan x-error, Anda dapat menyediakan URL cadangan untuk diluncurkan jika pintasan mengalami kesalahan saat dijalankan dan gagal diselesaikan. Dalam kasus ini, Anda dapat menggunakan URL lain untuk menanggulangi masalah tersebut.