Difference between revisions of "API Details"

From Charitylog Manual
Jump to: navigation, search
(Purchasing and getting started)
(API Entities)
 
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[File:helpheader_small.png|right]]
 
[[File:helpheader_small.png|right]]
  
On this page you will find some technical details of the Dizions API that works with the system. This enables you to interact with your data without having to log in to the web interface. It is a RESTful API using JSON over https. For prices, please call the office.
+
The API enables technical users capable of writing their own applications to [[Integrations|integrate]] with their Charitylog or Crossdata instance without having to log in to the web interface. It is a RESTful API using JSON over https. For prices, please call the office. To enable API users please see [[Users#3rd_Party_System_Access|Users]].
 
 
 
 
[[File:API.png]]
 
  
 
=General Concepts=
 
=General Concepts=
Line 14: Line 11:
  
 
=API Entities=
 
=API Entities=
 +
The API is based around various entities. To avoid breaking changes, the names in the API are fixed. If you are a developer talking to end users, it's useful to know that many features have different names in the web application, particular because many features can be renamed by a local admin.
  
The API is based around various entities:
+
{| class="wikitable" style="margin:auto"
 
+
|-
[[API_Classification_Codes|classification_codes]], a tiered coding system used to classify done_contacts using .
+
! API name !! Description !! Renamable in web app? !! Typical names in web app
 
+
|-
[[API_clients|clients]], who are organisations/people that are people, e.g. clients, staff volunteers etc.  
+
| [[API_Classification_Codes|classification_codes]] || A tiered coding system used to classify done_contacts and referrals|| Y || Classification code, enquiry codes
 
+
|-
[[API_done_contacts|done_contacts]], which are completed actions.
+
| [[API_clients|clients]] || Organisations/people that are people, e.g. clients, staff volunteers etc. || Y || Clients, Service Users, Staff, Volunteers
 
+
|-
[[API_due_contacts|due_contacts]], which are outstanding actions that typically make up the Action List in the web application.
+
| [[API_clinics|clinics]] || Group Activities || N || Clubs and Clinics
 
+
|-
[[API:_Extension_Databases| extension_databases]], used to create your own data structures for forms etc
+
| [[API_done_contacts|done_contacts]] || Completed actions || N || Contacts
 
+
|-
[[API_external_referrals|external_referrals]], which are referrals collected externally, e.g. a self-referral form on your website.
+
| [[API_due_contacts|due_contacts]] || Outstanding actions that typically make up the Action List in the web application || N || Outstanding actions
 
+
|-
[[API_referrals|referrals]], which are are a groups of done_contacts and due_contacts.
+
| [[API:_Extension_Databases| extension_databases]] || Used to create your own data structures for forms etc || N || Extension Databases
 
+
|-
[[API_relationships| relationship_details]] between 2 people, e.g. parent, social worker, carer etc.
+
| [[API_external_referrals|external_referrals]] || Referrals collected externally, e.g. a self-referral form on your website || N || Inbound Referrals
 
+
|-
[[API_schedules|schedules]], which are Roster job cards.
+
| [[Project_Set_Up|project]] || A service your organisation provides  || Y || Project, Service, Department
 
+
|-
[[API_workers|workers]], who are the people who work on schedules.
+
| [[API_referrals|referrals]] || Groups of done_contacts and due_contacts || Y || Referrals, Cases, Enquiries
 +
|-
 +
| [[API_relationships| relationship_details]] || Relationships between 2 people, e.g. parent, social worker, carer etc || N || Relationships
 +
|-
 +
| [[API_schedules|schedules]] || Roster job cards || N || Jobs cards is not renamable, but the workers are, e.g. Home Helper Job Cards, Support Worker Job Cards etc
 +
|-
 +
| [[Referral_Templates#The_Stages.2FStatuses|stage]] || A stage on a template, e.g. Initial Assessment || N || Stage
 +
|-
 +
| status || A broad grouping of a stage, e.g. Being Supported, Not For Reports etc || N || Status
 +
|-
 +
| [[Referral_Templates|template]] || A workflow, e.g. a collection of stages to guide you through a case || N || Template
 +
|-
 +
| [[API_workers|workers]] || People who work on schedules || Y || Home Helpers, Support Workers, Carers
 +
|}
  
 
=Other=
 
=Other=
Line 61: Line 72:
  
 
[[Power BI with Power Query| Getting Started with Power Query in Power BI Desktop]]
 
[[Power BI with Power Query| Getting Started with Power Query in Power BI Desktop]]
 +
 +
[[Power Query - How to's| How to achieve more with Power Query]]
  
 
=Purchasing and getting started=
 
=Purchasing and getting started=

Latest revision as of 09:21, 15 August 2024

Helpheader small.png

The API enables technical users capable of writing their own applications to integrate with their Charitylog or Crossdata instance without having to log in to the web interface. It is a RESTful API using JSON over https. For prices, please call the office. To enable API users please see Users.

General Concepts

Why_use_an_API

API Dictionaries

API Authentication

API Entities

The API is based around various entities. To avoid breaking changes, the names in the API are fixed. If you are a developer talking to end users, it's useful to know that many features have different names in the web application, particular because many features can be renamed by a local admin.

API name Description Renamable in web app? Typical names in web app
classification_codes A tiered coding system used to classify done_contacts and referrals Y Classification code, enquiry codes
clients Organisations/people that are people, e.g. clients, staff volunteers etc. Y Clients, Service Users, Staff, Volunteers
clinics Group Activities N Clubs and Clinics
done_contacts Completed actions N Contacts
due_contacts Outstanding actions that typically make up the Action List in the web application N Outstanding actions
extension_databases Used to create your own data structures for forms etc N Extension Databases
external_referrals Referrals collected externally, e.g. a self-referral form on your website N Inbound Referrals
project A service your organisation provides Y Project, Service, Department
referrals Groups of done_contacts and due_contacts Y Referrals, Cases, Enquiries
relationship_details Relationships between 2 people, e.g. parent, social worker, carer etc N Relationships
schedules Roster job cards N Jobs cards is not renamable, but the workers are, e.g. Home Helper Job Cards, Support Worker Job Cards etc
stage A stage on a template, e.g. Initial Assessment N Stage
status A broad grouping of a stage, e.g. Being Supported, Not For Reports etc N Status
template A workflow, e.g. a collection of stages to guide you through a case N Template
workers People who work on schedules Y Home Helpers, Support Workers, Carers

Other

File Uploads

Reading data (GETs)

API Filters

Selecting Specific Fields

Running Reports

Writing data (POSTs and PUTs)

Creating Records

Updating Records

External Referrals

Making the most of your data

Getting Started with Power Query with Excel

Getting Started with Power Query in Power BI Desktop

How to achieve more with Power Query

Purchasing and getting started

Purchasing

Working with existing API partners

Sample Calls