Aufgaben-API (/tasks)
Mit der Benutzer-API können Sie Benutzer erstellen, aktualisieren oder abfragen.
Übersicht
Mit der Aufgaben-API können Sie Standard-Aktionen zum ABRUFEN, SETZEN, POSTEN und LÖSCHEN ausführen. Sie können auch über ihre eigenen Endpunkte auf Aufgaben zugreifen, die Projekten oder Gruppen zugeordnet sind:/projects/{project_id}/tasks und/user_groups/{user_group_id}/tasks .
Weitere Informationen finden Sie unter Integrations-Best Practices.
Aktionen
Mit der Aufgaben-API können Sie:
| Verb | Pfad | Aktion | Beschreibung |
|---|---|---|---|
| BEITRAG |
/api/user_groups/:user_group_id/tasks
|
erstellen | Gruppenaufgabe erstellen |
| BEITRAG |
/api/projects/:project_id/tasks
|
erstellen | Projektaufgabe erstellen |
| BEITRAG |
/api/tasks
|
erstellen | Aufgabe erstellen |
| LÖSCHEN |
/api/projects/:project_id/tasks/:id
|
zerstören | Projektaufgabe löschen |
| LÖSCHEN |
/api/tasks/:id
|
zerstören | Aufgabe löschen |
| ABFRAGEN |
/api/user_groups/:user_group_id/tasks
|
index | Query Group Task |
| ABFRAGEN |
/api/projects/:project_id/tasks
|
index | Projektaufgabe abfragen |
| ABFRAGEN |
/api/tasks
|
index | Query-Task |
| ABFRAGEN |
/api/user_groups/:user_group_id/tasks/:id
|
anzeigen | Gruppenaufgabe anzeigen |
| ABFRAGEN |
/api/projects/:project_id/tasks/:id
|
anzeigen | Projektaufgabe anzeigen |
| ABFRAGEN |
/api/tasks/:id
|
anzeigen | Aufgabe anzeigen |
| PATCH |
/api/user_groups/:user_group_id/tasks/:id
|
aktualisierung | Gruppenaufgabe aktualisieren |
| PUT |
/api/user_groups/:user_group_id/tasks/:id
|
aktualisieren | Gruppenaufgabe aktualisieren |
| PATCH |
/api/projects/:project_id/tasks/:id
|
aktualisieren | Projektaufgabe aktualisieren |
| PUT |
/api/projects/:project_id/tasks/:id
|
aktualisieren | Projektaufgabe aktualisieren |
| PATCH |
/api/tasks/:id
|
aktualisierung | Aufgabe aktualisieren |
| PUT |
/api/tasks/:id
|
aktualisieren | Aufgabe aktualisieren |
Elemente
Folgende Elemente stehen für die Task-API zur Verfügung:
| Element | Beschreibung | Pflichtfeld? | Eindeutig? | Zulässiger Wert | Api_In Field? | Api_Out-Feld? | Datentyp |
|---|---|---|---|---|---|---|---|
| created-at | Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ | ja | datum/Uhrzeit | ||||
| erstellt von | Benutzer der Erstellung | ja | Benutzer | ||||
| beschreibung | beschreibung | ja | ja | text | |||
| fälligkeitsdatum | fälligkeit | ja | ja | datum/Uhrzeit | |||
| dauer | dauer | ja | ja | schwimmer | |||
| iD | Eindeutige Coupa-ID | ja | ganze Zahl | ||||
| verknüpfbar | Assoziation, mit der die Aufgabe verknüpft ist. Mögliche Werte sind „Benutzergruppe“/„Projekt“ | ja | ja | Aufgabe | |||
| linkable-id | ID der Benutzergruppe oder des Projekts, mit dem die Aufgabe verknüpft ist | ja | ja | ganze Zahl | |||
| verknüpfbarer Typ | verknüpfter Objekttyp.Aufgabe kann mit einer Benutzergruppe oder einem Projekt verknüpft werden | ja | ja | string(255) | |||
| vertragsverantwortlicher | Verantwortlicher | ja | ja | Benutzer | |||
| owner-id | Benutzer-ID, dem die Aufgabe zugewiesen wurde | ja | ja | ganze Zahl | |||
| prozentsatz | prozentsatz | 0 bis 100 | ja | ja | ganze Zahl | ||
| gelöst-at | Zeitstempel, mit dem die Aufgabe gelöst wurde, im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ | ja | datum/Uhrzeit | ||||
| gelöst durch | Benutzer, der die Aufgabe gelöst hat | ja | Benutzer | ||||
| startdatum | startdatum | ja | ja | datum/Uhrzeit | |||
| status | status der Aufgabe | ja | ja | string(255) | |||
| task-id | Eindeutige Kennung für eine Aufgabe, die nicht bearbeitet werden kann. Dies wird automatisch generiert. Dies wird als eindeutige Kennung verwendet, um Aufgaben in Ladern zu aktualisieren | ja | ganze Zahl | ||||
| titel | titel | ja | ja | ja | string(255) | ||
| updated-at | Automatisch von Coupa erstellt im Format JJJJ-MM-TTTHH:MM:SS+HH:MMZ | ja | datum/Uhrzeit | ||||
| aktualisiert von | Benutzer der Aktualisierung | ja | Benutzer |