캔버스 실행 호출
video_run 의 action 과 입력입니다.도구와 동작
video_run은 action 하나로 실행의 모든 단계를 다룹니다. 이 도구는 체리를 쓰는 모드이며 start가 노드마다 체리를 보류합니다.| action | 하는 일 |
|---|---|
quote | 실행 견적. 부작용이 없습니다. |
start | 실행을 시작합니다. |
get | 실행 하나의 상태를 읽습니다. |
get_active | 문서에서 끝나지 않은 실행 중 가장 최근 것을 읽습니다. 없으면 비어 있습니다. |
cancel | 실행을 취소합니다. |
입력
| 필드 | 쓰는 action | 설명 |
|---|---|---|
action | 모두 | 위 표의 값 |
documentId | quote, start, get_active | 캔버스 문서 id |
deploymentId | quote, start | 배포 리비전을 고정해 실행합니다. 쓰면 nodeIds와 regenerate는 함께 쓸 수 없습니다. |
nodeIds | quote, start | 실행할 노드. 생략하면 문서 전체입니다. 최대 200개. |
answers | quote, start | 분기 노드가 읽을 입력 답. 견적과 시작에서 같아야 합니다. |
regenerate | quote, start | 다시 만들 노드 |
quoteDigest | start | 견적이 돌려준 값을 그대로 |
confirmedTotalCherry | start | 사용자가 확인한 합계 |
runId | get, cancel | 시작이 돌려준 실행 id |
idempotencyKey | 모두(필수) | 8~128자. start만 사용합니다. |
견적에서 시작까지
서버는
start에서 같은 입력으로 견적을 다시 계산합니다. quoteDigest가 다르거나 새 합계가 확인한 금액을 넘으면 conflict로 거절합니다. 가격이 내려간 것은 허용됩니다. 견적에 문제 노드가 있으면 시작이 거절되므로 먼저 문서를 고칩니다.같은
idempotencyKey로 start를 다시 부르면 새 실행을 만들지 않고 같은 실행을 돌려줍니다(created=false).사람이 결정해야 하는 노드
승인 노드는 이 도구로 승인하거나 반려할 수 없습니다. 실행이 승인 대기에서 멈춰 있으면 사용자에게 웹에서 결정해 달라고 알립니다. 승인 노드는 마감 시각(
approvalExpiresAt)이 있습니다.취소
cancel은 아직 시작하지 않은 노드를 무료로 걷어 냅니다. 이미 접수된 노드 작업이 실패하면 보류한 체리는 각 작업의 정산에서 환불됩니다.