API done contacts

From Charitylog Manual
Revision as of 10:51, 24 February 2022 by Msim (talk | contribs)
Jump to: navigation, search

Go to API overview

These are completed actions, which are equivalent to the top half of Record a Contact in the web application. They are created like this, using the referral number

[POST] https://api.dizions.co.uk/v2/done_contacts/referral/127

The body must contain all of the following keys for creation:

user
stage
start_date
end_date
description

Optionally, you can also add:

travel_time
travel_mileage
transport_method
contact_type
priority

This will return the id, which can be used for editing, at least one of the required or optional keys, like this:

[PUT] https://api.dizions.co.uk/v2/done_contacts/456


NB the done_contact is also used to complete a due_contact, because conceptually, you are converting a due_contact into a done_contact when completing it. Also see the page on due_contacts

There are various validation rules in the web to make optional fields compulsory for users of the web app, for example if you require a priority for every referral. These settings are not implemented in the API, as the data avilable to the API caller may be different to user of the web app. The assumption is that the caller will perform its own validation.