crowdin / crowdin/crowdin-api-client-python
Tasks API updates - syncScope, originalWordsCount, and model fixes
- Linguagem predominante
- Python
- Estrelas
- 69
- Forks
- 39
- Merge médio
- 23h 35min
- PRs com merge (30d)
- 8
Descrição
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)
Guia de contribuição
Direção de pesquisa
Comece inspecionando os modelos tipados usados pelos endpoints de tarefas de projeto, organização e usuário listados, usando as referências de API vinculadas para verificar os campos da resposta e os valores de enum. Está concluído quando os modelos afetados de Crowdin e Enterprise expõem os novos campos, os tipos corrigidos e os caminhos de patch com a nulabilidade documentada e o escopo exclusivo do Enterprise.
Escrita pelo modelo de indexação a partir do texto da issue.
Avaliação
- Stack de tecnologia
- python
- Domínio
- api
- Tipo de issue
- Funcionalidade
- Dificuldade
- 3/5
- Tempo estimado
- 1-2 dias
- Status de atividade
- Ativa
- Clareza
- Razoavelmente clara
- Facilidade para iniciantes
- 68/100