API: Sample Calls

From Charitylog Manual
Revision as of 15:06, 21 March 2023 by Msim (talk | contribs)
Jump to: navigation, search

Go to API overview

There are a range of tools that can be used for making API calls. Postman is a popular choice, see https://www.postman.com/ You will need your keys added to an evironment as per the screenshot below, which will mean you don't need to add the keys to the header of every call you make. See this page for more info.

File:Postman environment.png

Copy and paste the the code below into a text editor, and save with a .json extension. The file can then be imported into Postman.

{
	"info": {
		"_postman_id": "10bed371-4395-442e-9a66-6a780d834776",
		"name": "Sample calls",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
	},
	"item": [
		{
			"name": "Getting Started",
			"item": [
				{
					"name": "Get Business Configuration",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Source",
								"value": "{{source}}",
								"type": "default"
							},
							{
								"key": "Org",
								"value": "{{org}}",
								"type": "default"
							},
							{
								"key": "User",
								"value": "{{user}}",
								"type": "default"
							}
						],
						"url": {
							"raw": "https://{{host}}/v2/business/configuration",
							"protocol": "https",
							"host": [
								"{{host}}"
							],
							"path": [
								"v2",
								"business",
								"configuration"
							]
						}
					},
					"response": []
				}
			]
		},
		{
			"name": "clients",
			"item": [
				{
					"name": "Client by ID with default fields",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Org",
								"value": "{{org}}"
							},
							{
								"key": "Source",
								"value": "{{source}}"
							},
							{
								"key": "User",
								"value": "{{user}}"
							},
							{
								"key": "XDEBUG_SESSION",
								"value": "PHPSTORM"
							}
						],
						"url": {
							"raw": "https://{{host}}/v2/clients/id/123",
							"protocol": "https",
							"host": [
								"{{host}}"
							],
							"path": [
								"v2",
								"clients",
								"id",
								"123"
							]
						}
					},
					"response": []
				},
				{
					"name": "Client by ID with specific fields",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Org",
								"value": "{{org}}"
							},
							{
								"key": "Source",
								"value": "{{source}}"
							},
							{
								"key": "User",
								"value": "{{user}}"
							},
							{
								"key": "XDEBUG_SESSION",
								"value": "PHPSTORM"
							}
						],
						"url": {
							"raw": "https://{{host}}/v2/clients/id/123/field/name;id;living_arrangements;accommodation",
							"protocol": "https",
							"host": [
								"{{host}}"
							],
							"path": [
								"v2",
								"clients",
								"id",
								"123",
								"field",
								"name;id;living_arrangements;accommodation"
							]
						}
					},
					"response": []
				}
			]
		},
		{
			"name": "referrals",
			"item": [
				{
					"name": "Referral by ID with default fields",
					"request": {
						"method": "GET",
						"header": [
							{
								"key": "Source",
								"value": "{{source}}"
							},
							{
								"key": "Org",
								"value": "{{org}}"
							},
							{
								"key": "User",
								"value": "{{user}}"
							},
							{
								"key": "XDEBUG_SESSION",
								"value": "PHPSTORM"
							}
						],
						"url": {
							"raw": "https://{{host}}/v2/referrals/id/1342",
							"protocol": "https",
							"host": [
								"{{host}}"
							],
							"path": [
								"v2",
								"referrals",
								"id",
								"1342"
							]
						}
					},
					"response": []
				}
			]
		}
	]
}