Kunder
Hent specifik
Henter en specifik (enkelt) kunde.
GET https://app.tasks.dk/api/client/x (hvor x erstattes med kundens id)
Response
<reply>
<status>
…
</status>
<data>
<client>
<id>(int) Id</id>
<name>(string) Firmanavn</name>
<address>(string) Adresse</address>
<postal-code>(string) Postnr</postal-code>
<city>(string) Bynavn</city>
<country>(string) Land</country>
<contact-person>(string) Kontaktpersons navn</contact-person>
<vat-number>(string) CVR-nummer</vat-number>
<email>(string) Email</email>
<created>(datetime) Dato for oprettelse</created>
<modified>(datetime) Dato for opdatering</modified>
</client>
</data>
</reply>
Hent alle
Henter alle kunder for din konto.
GET https://app.tasks.dk/api/clients
Response
<reply>
<status>
…
</status>
<data>
<client>
…
</client>
<client>
…
</client>
…
</data>
</reply>
Opret
Opretter en kunde.
POST https://app.tasks.dk/api/clients
Ved oprettelse af kunder er der følgende regler:
- Kun ‘name’ er påkrævet. Resten er valgfrie.
- ‘id’, ‘city’, ‘created’ og ‘modified’ skal aldrig angives. De ignoreres selvom de angives.
- Angivelse af landenavne følger de engelske navne – dem man kan se i brugergrænsefladen. Altså eksempelvis ‘Denmark’.
Request
<data>
<name>Verdensfirmaet A/S</name>
</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 kunde.
PUT https://app.tasks.dk/api/client/x (hvor x erstattes med kundens id)
De samme regler gælder her, som for oprettelse af kunder.
Request
Se samme under “Opret”.
Response
Se samme under “Hent specifik”.
Slet
Sletter en kunde, hvis brugeren har rettighederne til det.
DELETE https://app.tasks.dk/api/client/x (hvor x erstattes med kundens id)
Bemærk: Ved sletning slettes alle relaterede data også uden advarsel! Det vil i dette tilfælde sige projekter, opgaver, kommentarer, timeregistreringer og fakturaer.
Response
<reply>
<status>
…
</status>
<data></data>
</reply>