Chuyển tới nội dung chính

Decide a category suggestion

POST/api/category-suggestions/{suggestionId}/decision
Quản trị viên

Đọc thêm: CategoryMã nguồn: CategoryApiController#decide(mở trong thẻ mới)

Tham số đường dẫn​

TênKiểuBắt buộcGhi chú
suggestionIdstring (uuid)Bắt buộc

Request body​

application/json

TrườngKiểuBắt buộcGhi chú
decisionenum CategorySuggestionStatusBắt buộcPENDING_REVIEWAPPROVEDMAPPEDREJECTED
categoryIdstring (uuid)Tùy chọn

Response​

Thành công: 200

TrườngKiểuBắt buộcGhi chú
idstring (uuid)Tùy chọn
projectIdstring (uuid)Tùy chọn
changeIdstring (uuid)Tùy chọn
proposedCodestringTùy chọn
proposedNamestringTùy chọn
proposedGroupenum CategoryGroupTùy chọnFEATUREFIXPERFORMANCEDOCUMENTATIONMAINTENANCEOTHER
rationalestringTùy chọn
statusenum CategorySuggestionStatusTùy chọnPENDING_REVIEWAPPROVEDMAPPEDREJECTED
resolvedCodestringTùy chọn
deciderNamestringTùy chọn
createdAtstring (date-time)Tùy chọn
decidedAtstring (date-time)Tùy chọn

Lỗi​

Trạng tháiMãÁp dụng cho
400validation_failedthiếu trường hoặc giá trị nằm ngoài khoảng cho phépMọi endpoint
400malformed_requestkhông đọc được bodyMọi endpoint
400invalid_parametermột tham số trên đường dẫn hoặc query bị thiếu hoặc không chuyển đổi được, chẳng hạn một ID không phải UUIDMọi endpoint
401authentication_requiredchưa có phiên đăng nhậpMọi endpoint
403access_deniedendpoint dành cho quản trị viên, hoặc CSRF token thiếu hay đã cũMọi endpoint
404not_foundkhông có địa chỉ đóMọi endpoint
405method_not_allowedđịa chỉ không nhận phương thức đóMọi endpoint
415unsupported_media_typeđịa chỉ không đọc body thuộc kiểu đóMọi endpoint
500internal_errormột lỗi ReleaseFlow không lường trước; body không bao giờ chứa exception gây ra nóMọi endpoint
400invalid_change_filterKhu vực Changes
400invalid_change_reviewKhu vực Changes
400invalid_sensitive_pathsKhu vực Changes
404change_not_foundKhu vực Changes
404duplicate_candidate_not_foundKhu vực Changes
409change_processingKhu vực Changes
409change_not_eligible_for_aiKhu vực Changes
409duplicate_candidate_decidedKhu vực Changes
409change_excludedKhu vực Changes
409change_in_releaseKhu vực Changes
502ai_classification_failedKhu vực Changes
503ai_classification_unavailableKhu vực Changes
404category_not_foundKhu vực Categories
404category_suggestion_not_foundKhu vực Categories
409category_code_takenKhu vực Categories
409category_systemKhu vực Categories
409category_suggestion_decidedKhu vực Categories

Request

bash
# Sign in first and keep the session cookie in cookies.txt (see Sessions and CSRF).
# CSRF_HEADER and CSRF_TOKEN are the headerName and token GET /api/csrf returned.
curl -X POST "http://localhost:8080/api/category-suggestions/$SUGGESTION_ID/decision" \
-b cookies.txt -c cookies.txt \
-H "$CSRF_HEADER: $CSRF_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"decision": "PENDING_REVIEW",
"categoryId": "<uuid>"
}'

Request body là ví dụ dựng từ schema; thay mọi giá trị giữ chỗ trước khi gửi.

Response

200

Ví dụ

{
  "id": "<uuid>",
  "projectId": "<uuid>",
  "changeId": "<uuid>",
  "proposedCode": "<string>",
  "proposedName": "<string>",
  "proposedGroup": "FEATURE",
  "rationale": "<string>",
  "status": "PENDING_REVIEW",
  "resolvedCode": "<string>",
  "deciderName": "<string>",
  "createdAt": "<date-time>",
  "decidedAt": "<date-time>"
}