Kommentarer
Hent specifik
Henter en specifik (enkelt) kommentar.
GET https://app.tasks.dk/api/comment/x (hvor x erstattes med kommentarens id)
Response
<reply>
<status>
…
</status>
<data>
<task-comment>
<id>(int) Id</id>
<task-id>(int) Opgaveid</task-id>
<user-id>(int) Brugerid</user-id>
<comment>(string) Tekst</comment>
<created>(datetime) Dato for oprettelse</created>
<modified>(datetime) Dato for opdatering</modified>
</task-comment>
</data>
</reply>
Hent alle for opgave
Henter alle kommentarer for en given opgave.
GET https://app.tasks.dk/api/task/x/comments (hvor x erstattes med opgavens id)
Response
<reply>
<status>
…
</status>
<data>
<task-comment>
…
</task-comment>
<task-comment>
…
</task-comment>
…
</data>
</reply>
Opret
Opretter en kommentar.
POST https://app.tasks.dk/api/comments
Ved oprettelse af kommentarerer der følgende regler:
- ‘task-id’ og ‘user-id’ er påkrævede.
- ‘id’, ‘created’ og ‘modified’ skal aldrig angives. De ignoreres selvom de angives.
- Hvis ‘comment’ indeholder HTML, XML eller specielle tegn, skal indholdet pakkes ind i et CDATA-element, fx <![CDATA[tekst med <strong>html</strong>]]>.
Request
<data>
<task-id>1</task-id>
<user-id>10</user-id>
<comment>Min nye kommentar</comment>
</data>
Bemærk, som beskrevet under Best practice, at kun udfyldte/aktuelle felter behøver sendes.
Response
Se samme under “Hent specifik”.
Slet
Sletter en kommentar, hvis brugeren har rettighederne til det.
DELETE https://app.tasks.dk/api/comment/x (hvor x erstattes med kommentarens id)
Bemærk: Ved sletning slettes alle relaterede data også uden advarsel! Det vil i dette tilfælde sige vedhæftede filer.
Response
<reply>
<status>
…
</status>
<data></data>
</reply>