단축어에서 x-callback-url 사용하기
단축어는 특정 상호 작용이 완료되면 호출하는 앱이 응답(콜백)을 받도록 허용하는 x-callback-url을 지원합니다. URL 스킴을 사용하여 단축어 실행하기 및 URL 스킴을 사용하여 단축어 가져오기에서 안내한 대로 동일한 매개변수를 사용하여 x-callback-url에서 단축어를 가져오고 실행할 수 있습니다. 다음은 예제입니다.
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을 제공할 수 있습니다. OmniFocus에 있는 여러 단계의 작업 체크리스트와 함께 사용할 수 있습니다. 여기서 사용자는 x-callback-url을 열어 단축어를 실행하고, 목록을 반환하고, URL을 통해 다음 동작으로 넘어갈 수 있습니다.
x-cancel로 실행을 마치기 전에 단축어가 중단된 경우 실행할 예비용 URL을 제공할 수 있습니다. 단축어가 완료되지 않았기 때문에 단축어에서 제공된 출력이 없습니다.
x-error로 단축어가 실행 도중 오류로 인해 중단된 경우, 실행할 예비용 URL을 제공할 수 있습니다. 이 경우에 다른 URL을 사용하여 이 문제를 처리할 수 있습니다.