Prøv Tasks Pro gratis i 30 dage. Intet betalingskort nødvendigt, ingen forpligtelser.

Projekter

Hent specifikt

Henter et specifikt (enkelt) projekt.

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

Response

<reply>
   <status>
   …
   </status>
   <data>
      <project>
         <id>(int) Id</id>
         <name>(string) Projektnavn</name>
         <active>(bool) true hvis projektet er aktivt, false hvis det er deaktiveret</active>
         <client-id>(int) Kundeid</client-id>
         <budget-hours>(int) Projektbudget, antal hele timer</budget-hours>
         <created>(datetime) Dato for oprettelse</created>
         <modified>(datetime) Dato for opdatering</modified>
      </project>
   </data>
</reply>

 

Hent alle

Henter alle projekter for din konto.

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

Response

<reply>
   <status>
   …
   </status>
   <data>
      <project>
      …
      </project>
      <project>
      …
      </project>
      …
   </data>
</reply> 

 

Hent alle for kunde

Henter alle projekter for en given kunde.

GET https://app.tasks.dk/api/client/x/projects (hvor x erstattes med kundens id)

Response

Se samme under “Hent alle”.

 

Opret

Opretter et projekt.

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

Ved oprettelse af projekter er der følgende regler:

  • Kun ‘name’ og ‘client-id’ er påkrævet. Resten er valgfrie.
  • ‘id’, ‘active’, ‘created’ og ‘modified’ skal aldrig angives. De ignoreres selvom de angives. ‘active’ antager automatisk værdien true, medmindre kontoens abonnement er Tasks Free, og antallet af aktive projekter allerede er nået. I så fald oprettes projektet som inaktivt.
  • Hvis ‘budget-hours’ angives, skal det være et positivt heltal (ingen kommaer).

Request

<data>
   <name>Mit projekt</name>
   <client-id>10</client-id>
</data>

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

Response

Se samme under “Hent specifikt”.

 

Opdater

Opdaterer et projekt.

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

Ved opdatering af projekter er der følgende regler:

  • Kun ‘name’ er påkrævet. Resten er valgfrie.
  • ‘active’ skal have værdien true eller false. Bemærk at hvis kontoens abonnement er Tasks Free, og antallet af aktive projekter er nået, har det ingen effekt at sætte ‘active’ til true.
  • ‘id’, ‘client-id’, ‘created’ og ‘modified’ skal aldrig angives. De ignoreres selvom de angives.
  • Hvis ‘budget-hours’ angives, skal det være et positivt heltal (ingen kommaer).

Request

Se samme under “Opret”.

Response

Se samme under “Hent specifikt”.

 

Slet

Sletter et projekt, hvis brugeren har rettighederne til det.

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

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

Response

<reply>
   <status>
   …
   </status>
   <data></data>
</reply>