Opgaver

Hent specifik

Henter en specifik (enkelt) opgave.

GET https://app.tasks.dk/api/task/x (hvor x erstattes med opgavens id)

Response

<reply>
<status>
…
</status>
<data>
<project>
<id>(int) Id</id>
<project-id>(int) Projektid</project-id>
<title>(string) Opgavetitel</title>
<description>(string) Beskrivelse</description>
<priority>(int) Prioritet</priority>
<status>(int) Status</status>
<created>(datetime) Dato for oprettelse</created>
<modified>(datetime) Dato for opdatering</modified>
</project>
</data>
</reply>

Hent alle

Henter alle opgaver for din konto.

GET https://app.tasks.dk/api/tasks

Response

Hent alle for projekt

Henter alle opgaver for et givet projekt.

GET https://app.tasks.dk/api/project/x/tasks (hvor x erstattes med projektets id)

Response

Se samme under “Hent alle”.

Opret

Opretter en opgave.

POST https://app.tasks.dk/api/tasks

Ved oprettelse af opgaver er der følgende regler:

Kun ‘project-id’ og ‘title’ er påkrævet.
‘id’, ‘created’ og ‘modified’ skal aldrig angives. De ignoreres selvom de angives.
Gyldige værdier for ‘priority’: 1 (lav), 2 (normal – default), 3 (høj), 4 (kritisk).
Gyldige værdier for ‘status’: 1 (ny – default), 2 (afventer), 3 (påbegyndt), 4 (afsluttet), 5 (lukket).
Hvis ‘description’ indeholder HTML, XML eller specielle tegn, skal indholdet pakkes ind i et CDATA-element, fx <![CDATA[tekst med <strong>html</strong>]]>.

Request

<data>
<project-id>4</project-id>
<title>Min nye opgave</title>
</data>

Bemærk, som beskrevet under Best practice, at kun udfyldte/aktuelle felter behøver sendes.

Response

Se samme under “Hent specifik”.

Opdater

Opdaterer en opgave.

PUT https://app.tasks.dk/api/task/x (hvor x erstattes med opgavens id)

Ved opdatering af projekter er der følgende regler:

‘id’, ‘project-id’, ‘created’ og ‘modified’ skal aldrig angives. De ignoreres selvom de angives.
Gyldige værdier for ‘priority’: 1 (lav), 2 (normal), 3 (høj), 4 (kritisk).
Gyldige værdier for ’status’: 1 (ny), 2 (afventer), 3 (påbegyndt), 4 (afsluttet), 5 (lukket).
Hvis ‘description’ indeholder HTML, XML eller specielle tegn, skal indholdet pakkes ind i et CDATA-element, fx <![CDATA[tekst med <strong>html</strong>]]>.

Request

Se samme under “Opret”.

Response

Se samme under “Hent specifik”.

Slet

Sletter en opgave, hvis brugeren har rettighederne til det.

DELETE https://app.tasks.dk/api/task/x (hvor x erstattes med opgavens id)

Bemærk: Ved sletning slettes alle relaterede data også uden advarsel! Det vil i dette tilfælde sige kommentarer og timeregistreringer.

Response