Replace context
PUT
/api/projects/{projectId}/contextQuản trị viên
AI không biết gì về sản phẩm ngoài thay đổi đang được hỏi. Ngữ cảnh của một Project cho nó biết những điều nó không tự đoán được: phần nào là client và phần nào là server, setting nằm ở đâu, người dùng mở tính năng bằng cách nào, và những gì cố ý giữ tiếng Anh. Mở Ngữ cảnh Project trên thẻ của Project, hoặc gọi GET /api/projects/{projectId}/context, trả về context và người sửa lần cuối. Mọi thành viên đều đọc được; chỉ quản trị viên mới viết, trên trang hoặc bằng PUT /api/projects/{projectId}/context với {"context": "..."}. Đây là văn bản thuần, tối đa 2000 ký tự; dài hơn thì trả về 400 validation_failed, và để trống thì xoá nó.
Tham số đường dẫn
| Tên | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
projectId | string (uuid) | Bắt buộc |
Request body
application/json
| Trường | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
context | string | Tùy chọn | max LIMIT |
Response
Thành công: 200
| Trường | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
projectId | string (uuid) | Tùy chọn | |
context | string | Tùy chọn | |
updatedBy | string | Tùy chọn | |
updatedAt | string (date-time) | Tùy chọn |
Lỗi
| Trạng thái | Mã | Áp dụng cho |
|---|---|---|
400 | validation_failedthiếu trường hoặc giá trị nằm ngoài khoảng cho phép | Mọi endpoint |
400 | malformed_requestkhông đọc được body | Mọi endpoint |
400 | invalid_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 UUID | Mọi endpoint |
401 | authentication_requiredchưa có phiên đăng nhập | Mọi endpoint |
403 | access_deniedendpoint dành cho quản trị viên, hoặc CSRF token thiếu hay đã cũ | Mọi endpoint |
404 | not_foundkhông có địa chỉ đó | Mọi endpoint |
405 | method_not_allowedđịa chỉ không nhận phương thức đó | Mọi endpoint |
415 | unsupported_media_typeđịa chỉ không đọc body thuộc kiểu đó | Mọi endpoint |
500 | internal_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 |
400 | invalid_change_filter | Khu vực Changes |
400 | invalid_change_review | Khu vực Changes |
400 | invalid_sensitive_paths | Khu vực Changes |
404 | change_not_found | Khu vực Changes |
404 | duplicate_candidate_not_found | Khu vực Changes |
409 | change_processing | Khu vực Changes |
409 | change_not_eligible_for_ai | Khu vực Changes |
409 | duplicate_candidate_decided | Khu vực Changes |
409 | change_excluded | Khu vực Changes |
409 | change_in_release | Khu vực Changes |
502 | ai_classification_failed | Khu vực Changes |
503 | ai_classification_unavailable | Khu vực Changes |
404 | category_not_found | Khu vực Categories |
404 | category_suggestion_not_found | Khu vực Categories |
409 | category_code_taken | Khu vực Categories |
409 | category_system | Khu vực Categories |
409 | category_suggestion_decided | Khu 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 PUT "http://localhost:8080/api/projects/$PROJECT_ID/context" \
-b cookies.txt -c cookies.txt \
-H "$CSRF_HEADER: $CSRF_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"context": "<string>"
}'
Request body là ví dụ dựng từ schema; thay mọi giá trị giữ chỗ trước khi gửi.
Response
200Ví dụ
{
"projectId": "<uuid>",
"context": "<string>",
"updatedBy": "<string>",
"updatedAt": "<date-time>"
}