Create Assets
From MyMobileWorkers API
Revision as of 11:23, 6 August 2013 by Darren.atherton (Talk | contribs)
Contents |
Summary
| Create Asset | ||
|---|---|---|
| URL | http://base_url/api_path/version/assets | |
| Type | POST | |
| Params: | api_key | required |
| file | required | |
| update_existing | optional (default = false) | |
| validate_only | optional (default = false) | |
| Response | JSON | |
The 'create asset' method accepts an array of assets to be added to the system. If the 'update_existing' parameter is set, then any existing assets will be updated in the system. If set to false or not provided, then any asset where the serial number is not unique will be rejected.
If 'validate_only' is set, the assets will only be validated but not actually inserted into the database. This can be used to check an entire dataset for errors before submitting.
JSON Parameters
Example JSON
{"assets":[{ "external_id":"sss32", "item_id":{"name":"Woo"}, "serial_number":"serialNo123", "description":"describingwords", "location":"aPlace", "job_id":{"job_number":"123"}, "customer_id":{"name":"john"}, "status_id":{"status":"test"} }]}
Example curl request
curl -F validate_only=false -F update_existing=true -F api_key=darren_web_api -F file=@/Users/user/Desktop/webAPICurling/create_asset.txt http://live.mymobileworkers.com:8080/api/1/assets
Responses
Example JSON
{ "successful": [ {"serial_number":"S0103"}, {"serial_number":"S0245"} ], "failed": [ { "serial_number":"S0384", "errors": [ { "error_code":"ASV012", "error_msg":"Status id cannot be null." } ] } ] }