Codis d'error de Tasques
Tots els codis d'error de l'API pública que emet Tasques, amb el seu estat HTTP, el seu type i una pàgina per codi.
Codis d'error que emet Tasques. Cada code enllaça a la seva pròpia pàgina amb la causa i l'acció a prendre.
| Code | Type | HTTP | Descripció |
|---|---|---|---|
bulk_task_selection_too_large | invalid_request_error | 422 | L'operació massiva inclou més tasques de les que admet un sol lot (200 per defecte; el missatge diu el sostre vigent). No és un límit de peticions ni del pla: acota el que es processa d'una vegada. |
column_has_tasks | conflict_error | 409 | La columna que intentes esborrar encara té tasques i la petició no diu on portar-les. Per no deixar tasques sense lloc al tauler, l'esborrat es rebutja i no s'ha modificat res. |
column_slug_in_use | conflict_error | 409 | Una altra columna del mateix projecte ja té un nom equivalent. Es compara l'identificador que es deriva del nom, així que dos noms que només difereixen en majúscules o signes xoquen igualment. |
column_slug_reserved | invalid_request_error | 422 | El nom de la columna es tradueix a l'identificador planned o archived, reservats per als estats de les tasques que són fora del tauler. Una columna així seria indistingible d'aquests estats. |
invalid_custom_field_definition | invalid_request_error | 422 | La definició del camp personalitzat no és vàlida: nom fora d'1 a 60 caràcters, tipus desconegut, camp obligatori sense valor per defecte, opcions en un tipus que no les admet, canvi de tipus després de crear-lo, treure una opció que fan servir tasques, o una reordenació incompleta. error.param assenyala la dada concreta. |
invalid_custom_field_value | invalid_request_error | 422 | El valor no encaixa amb el tipus del camp personalitzat —per exemple, text en un camp numèric o una opció que no és a la llista— o el camp no pertany al projecte de la tasca. |
invalid_move_target_column | invalid_request_error | 422 | La columna indicada per rebre les tasques no serveix de destinació: no existeix, és d'un altre projecte o és la mateixa columna que s'està esborrant. L'esborrat no s'ha fet. |
invalid_task_key | invalid_request_error | 422 | La clau de tasca no té la forma CLAU-N —clau del projecte, guionet i número, com WEB-42— o el número de tasca no és un enter positiu. |
invalid_task_reference | invalid_request_error | 422 | Una tasca referenciada al cos de la petició no existeix o és d'una altra empresa; els dos casos responen igual. error.param indica quin camp contenia la referència. |
invalid_task_schedule | invalid_request_error | 422 | Les dates de la tasca no són coherents: la data d'inici és posterior a la data límit, o una de les dues no existeix al calendari (per exemple, un 30 de febrer). |
invalid_task_status | invalid_request_error | 422 | La destinació de la tasca no és vàlida: l'estat no existeix, la transició no està permesa, s'envien alhora columna i estat, la columna no és del projecte de la tasca, o es demana columna per a una tasca planificada o arxivada. Una tasca al tauler sempre té columna i una fora del tauler no en té mai. |
invalid_time_entry_period | invalid_request_error | 422 | El període de l'entrada de temps no és vàlid: el final és anterior a l'inici, dura més de 24 hores, l'inici és més d'un dia en el futur, una data no és vàlida, s'intenta treure el final d'una entrada tancada o es canvien les hores d'una entrada que continua en marxa. |
limit_exceeded | payment_required_error | 402 | L'empresa ha arribat al límit de factures o de documents anuals del seu pla; el missatge diu quin. A l'API v1 l'emet la facturació d'hores (POST /v1/projects/{project}/time-invoices), que ho comprova abans de crear res: no s'ha generat l'esborrany de factura ni s'ha marcat cap hora com a facturada. |
linked_entity_not_found | not_found_error | 404 | L'entitat que es vol vincular no existeix, és d'una altra empresa o pertany a un mòdul que l'empresa no té contractat; els tres casos responen igual. Passa en vincular (POST /v1/tasks/{task}/entity-links) i també en crear una tasca amb entity_link a POST /v1/tasks: en aquest cas la tasca NO es crea. |
project_archived | invalid_request_error | 422 | El projecte està arxivat i no admet tasques noves ni que s'hi moguin tasques. Arxivar congela el projecte sense esborrar-lo. |
project_column_not_found | not_found_error | 404 | La columna no existeix, pertany a un altre projecte o és d'una altra empresa; els tres casos responen igual. Una columna només s'adreça dins del projecte que la conté. |
project_has_no_columns | invalid_request_error | 422 | Es demana col·locar la tasca al tauler, però el projecte no té cap columna on posar-la. Una tasca activa sempre viu en una columna. |
project_key_in_use | conflict_error | 409 | La clau curta ja la fa servir un altre projecte de l'empresa, o continua reservada com a clau anterior d'un projecte que la va canviar. La clau dona nom a les tasques (WEB-42), així que no es pot repetir dins de l'empresa. |
project_not_found | not_found_error | 404 | No hi ha cap projecte amb aquest identificador o aquesta clau a l'empresa autenticada. Un projecte d'una altra empresa respon exactament igual, així que la resposta mai no revela si existeix en un altre lloc. |
required_custom_field_missing | invalid_request_error | 422 | Falta el valor d'un camp personalitzat que el projecte declara obligatori; el missatge anomena el camp. Un camp obligatori no pot quedar buit. |
task_already_in_project | invalid_request_error | 422 | Es demana traslladar la tasca al projecte on ja és, així que no hi ha cap trasllat per fer. |
task_assignee_not_member | invalid_request_error | 422 | L'usuari indicat com a assignat no és membre de l'empresa. Un usuari inexistent, d'una altra empresa o sense pertinença responen igual, per no revelar comptes aliens. |
task_attachment_not_found | not_found_error | 404 | L'adjunt no existeix, pertany a una altra tasca o és d'una altra empresa; els tres casos responen igual. Un adjunt esborrat ja no es pot consultar ni baixar. |
task_attachment_rejected | invalid_request_error | 422 | El fitxer no s'admet com a adjunt: és buit, supera els 10 MB, o el seu tipus real —detectat pel contingut (magic bytes), no per l'extensió ni per la capçalera— no està permès. També es rebutja una surface diferent de description o comment. |
task_calendar_feed_not_found | not_found_error | 404 | El feed de calendari (iCal) no existeix, està revocat, és d'una altra empresa o és el feed personal d'un altre usuari; tots els casos responen igual. Només l'emet l'aplicació web en rotar o revocar feeds, no l'API v1. |
task_column_capacity_exceeded | conflict_error | 409 | L'àmbit del tauler —la columna, o l'estat planificat o arxivat— ha esgotat el rang de posicions amb què s'ordenen les seves tasques. No és un límit del pla ni de permisos, sinó el sostre tècnic d'ordenació d'aquest àmbit. |
task_comment_not_editable | invalid_request_error | 422 | El comentari no es pot editar: només el seu autor el pot modificar, i els comentaris importats o portats per una integració són immutables per conservar el que va dir l'origen. |
task_comment_not_found | not_found_error | 404 | El comentari no existeix, pertany a una altra tasca o és d'una altra empresa; els tres casos responen igual. Un comentari només s'adreça sota la tasca on es va escriure. |
task_custom_field_not_found | not_found_error | 404 | El camp personalitzat no existeix, pertany a un altre projecte o és d'una altra empresa; els tres casos responen igual. Cada projecte defineix els seus propis camps. |
task_description_too_large | invalid_request_error | 422 | La descripció supera el màxim de 100.000 caràcters, comptats sobre el Markdown enviat abans de sanejar-lo. El sostre no depèn del pla: protegeix l'editor i l'emmagatzematge. |
task_entity_link_not_found | not_found_error | 404 | El vincle entre la tasca i un document, contacte, producte o empleat no existeix, pertany a una altra tasca o és d'una altra empresa; els tres casos responen igual. |
task_external_link_not_found | not_found_error | 404 | L'enllaç extern no existeix, pertany a una altra tasca o és d'una altra empresa. També respon així un enllaç que manté una integració (una issue o una pull request de la forja) quan s'intenta gestionar com si fos un enllaç manual. |
task_label_name_in_use | conflict_error | 409 | L'empresa ja té una etiqueta amb aquest nom; la comparació no distingeix majúscules de minúscules. Les etiquetes es comparteixen entre tots els projectes de l'empresa. |
task_label_not_found | not_found_error | 404 | No hi ha cap etiqueta amb aquest identificador a l'empresa autenticada; una etiqueta d'una altra empresa respon igual. Les etiquetes són de l'empresa, no d'un projecte concret. |
task_not_found | not_found_error | 404 | No hi ha cap tasca amb aquest identificador o aquesta clau a l'empresa autenticada. Una tasca d'una altra empresa —o, al portal de l'empleat, una que no té assignada— respon exactament igual. |
task_relation_cycle | invalid_request_error | 422 | La relació tancaria un cicle de subtasques o de bloquejos: la tasca de destinació ja depèn, directament o indirectament, de la d'origen, i cap de les dues no es podria completar primer. |
task_relation_exists | conflict_error | 409 | Entre aquestes dues tasques ja hi ha una relació del mateix tipus, en qualsevol de les dues direccions. Repetir-la no afegiria informació, així que no se'n crea una segona. |
task_relation_not_found | not_found_error | 404 | No hi ha cap relació amb aquest identificador entre tasques de l'empresa autenticada; una relació d'una altra empresa, o una ja esborrada, respon igual. |
task_self_relation | invalid_request_error | 422 | La tasca d'origen i la de destinació són la mateixa, i una tasca no es pot relacionar amb si mateixa. |
task_time_entry_invoiced | invalid_request_error | 422 | L'entrada de temps ja és inclosa en una factura. Mentre continuï vinculada no s'edita ni es torna a facturar, perquè la factura i les hores no es contradiguin. |
task_time_entry_not_found | not_found_error | 404 | L'entrada de temps no existeix, pertany a una altra tasca o és d'una altra empresa; els tres casos responen igual. |
task_time_not_invoiceable | invalid_request_error | 422 | No es poden facturar les hores demanades i el missatge anomena el motiu: el projecte no té client de facturació o aquest client ja no admet factures, falta tarifa per hora o producte amb preu, una entrada no és facturable, és en marxa o és d'un altre projecte, no hi ha entrades facturables, o la selecció és ambigua. |
task_timer_already_running | conflict_error | 409 | Ja tens un temporitzador en marxa en aquesta empresa. Cada usuari pot tenir-ne com a màxim un alhora per empresa, perquè el temps registrat no se solapi entre tasques. |
task_timer_not_running | invalid_request_error | 422 | Es demana aturar el temporitzador, però no en tens cap en marxa en aquesta empresa; potser ja es va aturar des d'una altra sessió o dispositiu. |
task_upload_link_expired | invalid_request_error | 410 | L'enllaç de pujada ja no serveix. El subcode diu per què: expired, perquè l'enllaç ha caducat (viu 30 minuts des que es va crear), o consumed, perquè ja es va fer servir una vegada i cada enllaç admet un únic enviament. |
task_upload_link_not_found | not_found_error | 404 | L'enllaç de pujada no és vàlid: el token està mal format o no correspon a cap enllaç, gairebé sempre perquè es va copiar incomplet. Un enllaç caducat o ja fet servir respon en canvi amb task_upload_link_expired. |
Relacionat
Codis d'error per categoria
Localitza un error per la categoria que l'emet.
Taula de referència completa
Tots els codis, estats HTTP, tipus i descripcions en una referència.
Model d'errors
Interpreta la resposta d'error i gestiona els errors per codi.