Utilizarea x-callback-url cu aplicația Scurtături pe Mac
Aplicația Scurtături este compatibilă cu x-callback-url, ceea ce permite ca aplicația care apelează să primească un răspuns (un callback) la finalizarea unei anumite interacțiuni. Puteți executa scurtături dintr‑un x-callback-url folosind aceiași parametri menționați în Executarea unei scurtături utilizând o schemă URL pe Mac. De exemplu:
shortcuts://x-callback-url/run-shortcut?name=calcul%20bac%C8%99i%C8%99&input=text&text=24,99&x-success=...&x-cancel=...
Pentru un x-callback-url standard, pot fi furnizați următorii parametri suplimentari:
x-success (opțional): Un URL care se deschide atunci când interacțiunea are succes, de exemplu, după ce o scurtătură este importată sau își finalizează execuția. Dacă o scurtătură este executată, la sfârșitul URL‑ului este adăugat un parametru numit
result, care conține ieșirea textuală a scurtăturii.x-cancel (opțional): Un URL care se deschide atunci când interacțiunea este anulată de către utilizator.
x-error (opțional): Un URL care se deschide atunci când interacțiunea eșuează din cauză că a survenit o eroare. La sfârșitul URL‑ului este adăugat un parametru numit
errorMessage, care conține o descriere a erorii.
Cu x-success, puteți furniza un URL care să se deschidă după executarea reușită a scurtăturii. Acesta ar putea fi utilizat împreună cu o listă de sarcini cu mai mulți pași, în care puteți să deschideți x-callback-url pentru a executa o scurtătură, să reveniți la listă și să treceți la sarcina următoare prin intermediul unui URL.
Cu x-cancel, un URL pentru situații accidentale, care să fie lansat dacă scurtătura se oprește înainte de a‑și finaliza execuția. Deoarece scurtătura nu s‑a finalizat, nu este furnizată nicio ieșire din scurtătură.
Cu x-error, un URL pentru situații accidentale, care să fie lansat dacă scurtătura întâmpină o eroare în timpul execuției și eșuează finalizarea. În acest caz, puteți lansa un alt URL pentru gestionarea situației.