HTTP API (2022-12-12) — Polytomic Docs

Connection

Configuration

NAME	TYPE	DESCRIPTION	REQUIRED	READONLY
url	string		true	false
headers	array		false	false
body	string		false	false
parameters	array		false	false
healthcheck	string	Path to request when checking the health of this connection. No health check will be performed if left empty.	false	false
auth	object		false	false

Example

1 {
2   "name": "api connection",
3   "type": "api",
4   "configuration": {
5     "auth": {
6         "basic": {
7             "password": "secret",
8             "username": "user@example.com"
9         },
10         "header": {
11             "name": "foo",
12             "value": ""
13         },
14         "oauth": {
15             "auth_style": 0,
16             "client_id": "client_id",
17             "client_secret": "client_secret",
18             "extra_form_data": [
19                 {
20                     "name": "foo",
21                     "value": ""
22                 }
23             ],
24             "scopes": [
25                 {}
26             ],
27             "token_endpoint": "https://example.com/oauth/token"
28         }
29     },
30     "body": "{\"key\":\"value\"}",
31     "headers": [
32         {
33             "name": "foo",
34             "value": ""
35         }
36     ],
37     "healthcheck": "https://example.com/healthz",
38     "parameters": [
39         {
40             "name": "foo",
41             "value": ""
42         }
43     ],
44     "url": "https://example.com"
45   }
46 }

Model Sync

Source

Configuration

NAME	TYPE	DESCRIPTION	REQUIRED	READONLY
method	string	Method Accepted Values: GET, POST	true	false
path	string	Path	false	false
record_path	string	Record JSON path	false	false
headers	array	Headers	false	false
parameters	array	Parameters	false	false
body	string	Request Body	false	false
pagination	object	Pagination	false	false
sampleResponse	string	API response	false	false

Example

1 {
2   ...
3   "configuration": {
4     "body": "",
5     "headers": [
6         {}
7     ],
8     "method": "",
9     "pagination": {},
10     "parameters": [
11         {}
12     ],
13     "path": "",
14     "record_path": "",
15     "sampleResponse": ""
16   }
17 }

1	{
2	"name": "api connection",
3	"type": "api",
4	"configuration": {
5	"auth": {
6	"basic": {
7	"password": "secret",
8	"username": "user@example.com"
9	},
10	"header": {
11	"name": "foo",
12	"value": ""
13	},
14	"oauth": {
15	"auth_style": 0,
16	"client_id": "client_id",
17	"client_secret": "client_secret",
18	"extra_form_data": [
19	{
20	"name": "foo",
21	"value": ""
22	}
23	],
24	"scopes": [
25	{}
26	],
27	"token_endpoint": "https://example.com/oauth/token"
28	}
29	},
30	"body": "{\"key\":\"value\"}",
31	"headers": [
32	{
33	"name": "foo",
34	"value": ""
35	}
36	],
37	"healthcheck": "https://example.com/healthz",
38	"parameters": [
39	{
40	"name": "foo",
41	"value": ""
42	}
43	],
44	"url": "https://example.com"
45	}
46	}

1	{
2	...
3	"configuration": {
4	"body": "",
5	"headers": [
6	{}
7	],
8	"method": "",
9	"pagination": {},
10	"parameters": [
11	{}
12	],
13	"path": "",
14	"record_path": "",
15	"sampleResponse": ""
16	}
17	}