cht@1.0.5
- get(path, options, [callback])
- post(path, body, options, [callback])
- put(path, options, [callback])
- request(method, path, data, options, [callback])
This adaptor exports the following from common:
- cursor()
- dataPath()
- dataValue()
- dateFns
- each()
- field()
- fields()
- fn()
- lastReferenceValue()
- merge()
- sourceValue()
Functions
get
get(path, options, [callback]) ⇒ Operation
Make a GET request against the base URL.
Param | Type | Description |
---|---|---|
path | string | Path to resource |
options | RequestOptions | Options to configure the HTTP request |
[callback] | function | Optional callback to handle the response |
This operation writes the following keys to state:
State Key | Description |
---|---|
data | the parsed response body |
response | the response from the CHT HTTP server, including headers, statusCode, body, etc |
references | an array of all previous data objects used in the Job |
Example: Get a list of contacts
get("/api/v2/export/contacts");
Example: Filter contacts given a name
get("/api/v2/export/contacts", {
query: {"filters": {
"search": "jim"
}}
});
post
post(path, body, options, [callback]) ⇒ Operation
Make a POST request against the base url
Param | Type | Description |
---|---|---|
path | string | Path to resource |
body | object | Object which will be attached to the POST body |
options | RequestOptions | Optional request options |
[callback] | function | Optional callback to handle the response |
This operation writes the following keys to state:
State Key | Description |
---|---|
data | the parsed response body |
response | the response from the CHT HTTP server, including headers, statusCode, body, etc |
references | an array of all previous data objects used in the Job |
Example: Create a new person
post("/api/v1/people", {
"name": "Hannah",
"phone": "+254712345678",
"type": "contact",
"contact_type": "patient", });
put
put(path, options, [callback]) ⇒ Operation
Make a PUT request against the base url
Param | Type | Description |
---|---|---|
path | string | Path to resource |
options | RequestOptions | Options to configure the HTTP request |
[callback] | function | Optional callback to handle the response |
This operation writes the following keys to state:
State Key | Description |
---|---|
data | the parsed response body |
response | the response from the CHT HTTP server, including headers, statusCode, body, etc |
references | an array of all previous data objects used in the Job |
Example: Update settings
put("/api/v1/settings",{query:{overwrite:true}});
request
request(method, path, data, options, [callback]) ⇒ Operation
Make a general HTTP request to CHT
Param | Type | Description |
---|---|---|
method | string | HTTP method to use |
path | string | Path to resource |
data | object | Object which will be attached to the POST body |
options | RequestOptions | Optional request options |
[callback] | function | Optional callback to handle the response |
This operation writes the following keys to state:
State Key | Description |
---|---|
data | the parsed response body |
response | the response from the CHT HTTP server, including headers, statusCode, body, etc |
references | an array of all previous data objects used in the Job |
Example
request("POST","/api/v1/people", {
"name": "Hannah",
"phone": "+254712345678",
"type": "contact",
"contact_type": "patient", });