DEVELOPER REFERENCE

One endpoint. Clear answers.

저장한 Decision에 새로운 State를 전달하세요.

POST /v1/decisions/:slug/run

Authorization: Bearer dcd_live_…
Content-Type: application/json

Request

{ "state": "중복 결제된 금액을 환불해 주세요." }

State는 1–16,000자 문자열입니다. 요청 전체는 64 KiB 이하입니다. 저장된 질문과 모델을 사용하며 요청에서 변경할 수 없습니다.

Response

{
  "result": {
    "department": "billing",
    "refund": true,
    "urgency": 2
  }
}

X-Decid-Execution-Id 응답 헤더로 실행 메타데이터를 식별할 수 있습니다. 응답 본문은 저장하지 않습니다.

Errors

400 입력 오류 · 401 인증 실패 · 404 Decision 없음
409 모델 미활성화 · 413 입력 크기 초과 · 429 호출 제한
502 제공사 또는 출력 오류 · 503 서비스 설정 오류 · 504 시간 초과

{ "error": { "code": "INVALID_MODEL_OUTPUT", "requestId": "…" } }

키당 분당 60회, Workspace당 분당 120회. 고정 윈도 기준입니다. 요청당 제공사 타임아웃은 20초이며 자동 재시도는 없습니다. 사용자가 재호출하면 별도 실행과 비용이 발생할 수 있습니다.

cURL

curl -X POST \
  https://decid.hov.kr/v1/decisions/refund-classifier/run \
  -H 'Authorization: Bearer YOUR_DECID_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"state":"중복 결제를 환불해 주세요."}'

저장과 실행

Decision은 생성 후 불변입니다. 질문을 바꾸려면 새 slug로 저장하세요. State와 응답은 호출마다 처리되고 휘발됩니다. 제공사 자체 보관 정책은 Decid와 별개입니다.