crowdin / crowdin/crowdin-api-client-python

Tasks API updates - syncScope, originalWordsCount, and model fixes

Đang mở
#282 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
enhancement good first issue
Ngôn ngữ chính
Python
Star
69
Fork
39
Merge trung bình
23 giờ 35 phút
Pull request đã merge (30 ngày)
8

Mô tả

Several updates landed on the Tasks API models that typed client libraries should pick up:

**New response fields:**

- `originalWordsCount` (integer) on the Task model — the number of words when the task was created, preserved when source strings are later removed (`wordsCount` reflects the current count). Both Crowdin and Crowdin Enterprise.
- `syncScope` (nullable object: `syncedWords`, `pendingWords`, `skippedWords` — all integers) on the Enterprise task models (project tasks, organization task list, user tasks). It is `null` when the task is fully synced, not shared, or the counterpart is unavailable — **Crowdin Enterprise only**.

**Type fixes:**

- Task `creatorId` corrected from string to **integer**.
- Enterprise Add Task forms: `status` corrected from integer to **string** enum (`todo`, `in_progress`).

**Edit Project Task (Enterprise):** the inter-organizational task patch `path` enum gains `/generateCostEstimate`, `/generateTranslationCost`, and `/reportSettingsTemplateId`.

Affected endpoints: **List/Add/Get/Edit Project Task** (`api.projects.tasks.getMany`/`post`/`get`/`patch`), **List Tasks** (Enterprise organization level, `api.tasks.getMany`), **List User Tasks** (`api.users.tasks.getMany` on crowdin.com).

**References:**
- [List Project Tasks](https://support.crowdin.com/developer/api/v2/#operation/api.projects.tasks.getMany)
- [Edit Task](https://support.crowdin.com/developer/api/v2/#operation/api.projects.tasks.patch)
- Crowdin Enterprise: [List Tasks](https://support.crowdin.com/developer/enterprise/api/v2/#operation/api.tasks.getMany), [Edit Task](https://support.crowdin.com/developer/enterprise/api/v2/#operation/api.projects.tasks.patch)

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Hướng nghiên cứu

Start by inspecting the typed models used by the listed project, organization, and user task endpoints, using the linked API references to verify the response fields and enum values. Done means the affected Crowdin and Enterprise models expose the new fields, corrected types, and patch paths with the documented nullability and Enterprise-only scope.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
python
Lĩnh vực
api
Loại issue
Tính năng
Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức độ hoạt động
Sôi nổi
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
68/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.