API de tâche (/tasks)
L'API utilisateurs vous permet de créer, mettre à jour ou interroger des utilisateurs.
Aperçu
L'API Task vous permet d'effectuer des actions standard GET, PUT, POST et DELETE. Vous pouvez également accéder aux tâches associées aux projets ou aux groupes via leurs propres points de terminaison :/projects/{project_id}/tasks
et/user_groups/{user_group_id}/tasks
.
Voir les meilleures pratiques d'intégration pour plus d'informations.
Actions
L'API de tâche vous permet de :
Verbe | Chemin d'accès | Action | Description |
---|---|---|---|
PUBLIER |
/api/user_groups/:user_group_id/tasks
|
créer | Créer une tâche de groupe |
PUBLIER |
/api/projects/:project_id/tasks
|
créer | Créer une tâche de projet |
PUBLIER |
/API/tâches
|
créer | Créer tâche |
SUPPRIMER |
/api/projects/:project_id/tasks/:id
|
détruire | Supprimer la tâche de projet |
SUPPRIMER |
/api/tasks/:id
|
détruire | Supprimer tâche |
OBTENIR |
/api/user_groups/:user_group_id/tasks
|
index | Tâche de groupe de requêtes |
OBTENIR |
/api/projects/:project_id/tasks
|
index | Demander la tâche du projet |
OBTENIR |
/API/tâches
|
index | Tâche de requête |
OBTENIR |
/api/user_groups/:user_group_id/tasks/:id
|
afficher | Afficher une tâche de groupe |
OBTENIR |
/api/projects/:project_id/tasks/:id
|
afficher | Afficher la tâche du projet |
OBTENIR |
/api/tasks/:id
|
afficher | Afficher la tâche |
PATCH |
/api/user_groups/:user_group_id/tasks/:id
|
mettre à jour | Actualiser la tâche de groupe |
METTRE |
/api/user_groups/:user_group_id/tasks/:id
|
mettre à jour | Mise à jour de la tâche de |
PATCH |
/api/projects/:project_id/tasks/:id
|
mettre à jour | Mettre à jour la tâche du projet |
METTRE |
/api/projects/:project_id/tasks/:id
|
mettre à jour | Mettre à jour la tâche du projet |
PATCH |
/api/tasks/:id
|
mettre à jour | Mettre à jour la tâche |
METTRE |
/api/tasks/:id
|
mettre à jour | Actualiser la tâche |
Éléments
Les éléments suivants sont disponibles pour l'API de tâche :
Élément | Description | Champ obligatoire ? | Unique ? | Valeur autorisée | Api_In Field ? | Api_Out Field ? | Type de données |
---|---|---|---|---|---|---|---|
created-at | Créé automatiquement par Coupa au format AAAA-MM-JJFHH :MM :SS+HH :MMZ | oui | datetime | ||||
créé par | Utilisateur qui a créé | oui | Utilisateur | ||||
description | description | oui | oui | texte | |||
due-date | date d'échéance | oui | oui | datetime | |||
durée | durée | oui | oui | flotteur | |||
iD | Identifiant unique Coupa | oui | nombre entier | ||||
linkable | Association à laquelle la tâche est liée. Les valeurs possibles sont UserGroup/Project | oui | oui | Tâche | |||
linkable-id | ID du groupe d'utilisateurs ou du projet auquel la tâche est liée | oui | oui | nombre entier | |||
linkable-type | type d'objet lié. Le cn de la tâche doit être lié à un groupe d'utilisateurs ou à un projet | oui | oui | string(255) | |||
propriétaire | Propriétaire | oui | oui | Utilisateur | |||
owner-id | Identifiant utilisateur auquel la tâche est attribuée | oui | oui | nombre entier | |||
pourcentage | pourcentage | 0 à 100 | oui | oui | nombre entier | ||
resolved-at | Horodatage la tâche a été résolue au format AAAA-MM-JJFHH :MM :SS+ HHH :MMZ | oui | datetime | ||||
résolu par | Utilisateur qui a résolu la tâche | oui | Utilisateur | ||||
date de début | date de début | oui | oui | datetime | |||
statut | statut de la tâche | oui | oui | string(255) | |||
task-id | Identifiant unique pour une tâche qui n'est pas modifiable. Ceci est généré automatiquement. Cela sera utilisé comme identifiant unique pour mettre à jour les tâches dans les chargeurs | oui | nombre entier | ||||
titre | titre | oui | oui | oui | string(255) | ||
mis-à-jour à | Créé automatiquement par Coupa au format AAAA-MM-JJFHH :MM :SS+HH :MMZ | oui | datetime | ||||
mis à jour par | Utilisateur ayant réalisé la mise à jour | oui | Utilisateur |