List release languages
GET
/api/organization/release-languagesThành viên đã đăng nhậpChỉ đọc
Mặc định mọi release note được viết bằng ngôn ngữ đầu ra của Organization. Quản trị viên có thể chọn tối đa năm ngôn ngữ release note ở đầu trang Audience, hoặc gọi PUT /api/organization/release-languages với {"targetLanguages": ["en", "vi"]}; mọi thành viên đọc được chúng bằng GET. Tag được chuẩn hoá và bỏ phần lặp; danh sách rỗng, nhiều hơn năm ngôn ngữ, hoặc tag không hợp lệ trả về 400 invalid_release_languages. Khi đó duyệt một release sẽ viết một release note cho mỗi audience và mỗi ngôn ngữ, nên bốn audience bằng tiếng Anh và tiếng Việt cho ra tám release note.
Response
Thành công: 200
| Trường | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
targetLanguages | array of string | Tùy chọn | |
outputLanguage | string | Tùy chọn | |
translationEnabled | boolean | Tùy chọn | |
updatedBy | string | Tùy chọn | |
updatedAt | string (date-time) | Tùy chọn | |
suggestions | array of OutputLanguageSettings.Option | Tùy chọn | |
suggestions[].tag | string | Tùy chọn | |
suggestions[].displayName | string | 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 | 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 |
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 | template_invalid | Khu vực Audiences |
400 | template_narratives_path | Khu vực Audiences |
400 | template_language_not_targeted | Khu vực Audiences |
400 | invalid_release_languages | Khu vực Audiences |
404 | audience_not_found | Khu vực Audiences |
409 | audience_code_taken | Khu vực Audiences |
409 | audience_limit | Khu vực Audiences |
409 | audience_last | Khu vực Audiences |
409 | audience_last_active | Khu vực Audiences |
409 | audience_already_retired | Khu vực Audiences |
409 | audience_not_retired | Khu vực Audiences |
409 | audience_in_use | Khu vực Audiences |
409 | audience_not_preset | Khu vực Audiences |
404 | glossary_term_not_found | Khu vực Glossary |
409 | glossary_term_taken | Khu vực Glossary |
409 | glossary_limit | Khu vực Glossary |
400 | invalid_release_schedule | Khu vực Releases |
400 | invalid_upgrade_guide_url | Khu vực Releases |
400 | invalid_previous_release | Khu vực Releases |
400 | invalid_fold_decision | Khu vực Releases |
404 | release_not_found | Khu vực Releases |
404 | release_note_not_found | Khu vực Releases |
404 | folding_suggestion_not_found | Khu vực Releases |
404 | linked_issue_not_found | Khu vực Releases |
409 | release_status_conflict | Khu vực Releases |
409 | release_published | Khu vực Releases |
409 | release_empty | Khu vực Releases |
409 | release_review_incomplete | Khu vực Releases |
409 | change_summary_required | Khu vực Releases |
409 | release_version_taken | Khu vực Releases |
409 | classification_changed | Khu vực Releases |
409 | change_not_releasable | Khu vực Releases |
409 | change_excluded | Khu vực Releases |
409 | release_note_render_failed | Khu vực Releases |
409 | release_notes_missing | Khu vực Releases |
409 | translations_not_ready | Khu vực Releases |
409 | linked_issue_status_changed | Khu vực Releases |
Request
bash
# Sign in first and keep the session cookie in cookies.txt (see Sessions and CSRF).
curl "http://localhost:8080/api/organization/release-languages" \
-b cookies.txt -c cookies.txt
Response
200Ví dụ
{
"targetLanguages": [
"<string>"
],
"outputLanguage": "<string>",
"translationEnabled": false,
"updatedBy": "<string>",
"updatedAt": "<date-time>",
"suggestions": [
{
"tag": "<string>",
"displayName": "<string>"
}
]
}