Difference between revisions of "API Entities"

From Charitylog Manual
Jump to: navigation, search
m (Msim moved page API Groups to API Entities without leaving a redirect)
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
[[API Details|Go to API overview]]
 +
 
[[File:helpheader_small.png|right]]
 
[[File:helpheader_small.png|right]]
  
 
The API is based around various entities:
 
The API is based around various entities:
  
* clients (organisations that are "people")
+
* clients. These are organisations/people that are people, e.g. clients, staff volunteers etc.
* referrals (diary)
+
* referrals. These are a groups of cohesive actions. These are typically called 'cases' in the web application. The web application's terminology section allows these to be renamed, but they are always called 'referrals' in the API. Only referral using a template are available in the API. In a future release of the web application, templates will be automatically created when new projects are created, so that all referrals will be available in the API. If you have older referrals without a template that you wish to access via the API, please contact the support team.
* done_contacts (completed actions)
+
* done_contacts. These are completed actions.
* due_contacts (outstanding actions)
+
* due_contacts. These are outstanding actions that typically make up the Action List in the web application.
* workers (support workers)
+
* workers. These are the people who work on Roster Job Cards. The web application's terminology section allows these to be renamed, but they are always called 'referrals' in the API.
* schedules (job cards)
+
* schedules. These are Roster job cards.
* external_referrals (referrals collected externally, e.g. a self-referral form on your website )
+
* external_referrals. These are referrals collected externally, e.g. a self-referral form on your website.
  
An example URL would look like (GET) https://api.dizions.co.uk/v2/clients
+
An example URL would look like:
 +
[GET] https<nowiki/>://api.dizions.co.uk/v2/clients/37

Revision as of 16:03, 26 August 2020

Go to API overview

Helpheader small.png

The API is based around various entities:

  • clients. These are organisations/people that are people, e.g. clients, staff volunteers etc.
  • referrals. These are a groups of cohesive actions. These are typically called 'cases' in the web application. The web application's terminology section allows these to be renamed, but they are always called 'referrals' in the API. Only referral using a template are available in the API. In a future release of the web application, templates will be automatically created when new projects are created, so that all referrals will be available in the API. If you have older referrals without a template that you wish to access via the API, please contact the support team.
  • done_contacts. These are completed actions.
  • due_contacts. These are outstanding actions that typically make up the Action List in the web application.
  • workers. These are the people who work on Roster Job Cards. The web application's terminology section allows these to be renamed, but they are always called 'referrals' in the API.
  • schedules. These are Roster job cards.
  • external_referrals. These are referrals collected externally, e.g. a self-referral form on your website.

An example URL would look like:

[GET] https://api.dizions.co.uk/v2/clients/37