Difference between revisions of "Update Custom List"
From MyMobileWorkers API
(→JSON Contents) |
|||
| (2 intermediate revisions by one user not shown) | |||
| Line 82: | Line 82: | ||
|- | |- | ||
! external_id | ! external_id | ||
| + | | varchar(255) || | ||
| + | |- | ||
| + | ! triggers | ||
| varchar(255) || | | varchar(255) || | ||
|- | |- | ||
| Line 100: | Line 103: | ||
"name":"Aldcliffe Site", | "name":"Aldcliffe Site", | ||
"notes":"small", | "notes":"small", | ||
| − | "order_position":5 | + | "order_position":5, |
| + | "triggers": "photo,fail,note" | ||
}, | }, | ||
{ | { | ||
"name":"Bond Estate", | "name":"Bond Estate", | ||
"notes":"medium", | "notes":"medium", | ||
| − | "order_position":6 | + | "order_position":6, |
| + | "triggers": "photo" | ||
} | } | ||
] | ] | ||
Latest revision as of 11:37, 12 March 2018
Contents |
[edit] Summary
The Update Custom List API call allows an existing list to be updated with a new name, description and list items by giving the list key within the request. When updating the list, it will delete any existing items in the custom list and replace with the items provided in the response.
A custom list can be updated via two different methods - either as multi-part form data, or as JSON content on its own, with the API key supplied within the JSON.
[edit] Multi Part Form Data
| Update Customer Name | ||
|---|---|---|
| URL | http://base_url/api_path/version/lists/edit | |
| Type | POST | |
| Params: | key | required |
| Response | JSON | |
[edit] JSON As Body
| Create Job - JSON | ||
|---|---|---|
| URL | http://base_url/api_path/version/list/edit | |
| Type | POST | |
| key | required | |
| branch_name | optional | |
| list (object) | required | |
| {list object} name | required | |
| {list object} description | optional | |
| {list object} list_key | required | |
| {list object} items | required | |
| Response | JSON | |
| Standard Fields | ||
|---|---|---|
| Field | Expected Data | Required |
| name | varchar(255) | ✓ |
| notes | varchar(255) | |
| order_position | int(11) | |
| external_id | varchar(255) | |
| triggers | varchar(255) | |
[edit] JSON Contents
{ "key":"APIKEY", "branch_name":"BranchA", "list":{ "name":"Delivery sites", "description":"A list of delivery sites in the area", "list_key":"delivery_site1", "list_items":[ { "name":"Aldcliffe Site", "notes":"small", "order_position":5, "triggers": "photo,fail,note" }, { "name":"Bond Estate", "notes":"medium", "order_position":6, "triggers": "photo" } ] } }
[edit] Example Curl Request
[edit] Multi Part Form Data
curl -F api_key=YOUR_KEY http://api.mymobileworkers.com:8080/api/1/lists/edit
[edit] JSON As Body
curl -X POST -H "Content-Type: application/json" -d '{"key":"YOUR_KEY"}' http://api.mymobileworkers.com:8080/api/1/lists/edit
[edit] Responses
[edit] Successful
{ "successful": { "list_name": "Delivery sites", "branch_name": null } }
[edit] Unsuccessful
{"error_code": "LIS002", "error_message": "List not found."} {"error_code": "LIS001", "error_message": "List key not provided. Please include in request."} { "error_code": "LIS004", "error_message": "No items were provided."}
