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

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