Difference between revisions of "Create Company Attachment Folders"
From MyMobileWorkers API
(→Multi Part Form Data) |
(→JSON As Body) |
||
| Line 111: | Line 111: | ||
<source lang="java"> | <source lang="java"> | ||
{ | { | ||
| − | "key":" | + | "key":"api_key", |
| − | " | + | "validate_only":"false", |
| − | " | + | "update_existing":true, |
| + | "folders":[ | ||
{ | { | ||
| − | + | "name":"folder_test", | |
| − | + | "notes":"testing", | |
| − | + | "order_position":1, | |
| − | + | "folder_key":"folder_key" | |
| − | + | ||
| − | + | ||
} | } | ||
] | ] | ||
} | } | ||
| + | |||
</source> | </source> | ||
Revision as of 10:55, 12 March 2018
Contents |
Summary
A company folder can be created via two different methods - either as multi-part form data with a JSON file attached and the API key as a parameter, or as JSON content on it's own, with the API key supplied within the JSON.
Multi Part Form Data
| Create Item | ||
|---|---|---|
| URL | http://base_url/api_path/version/companies/company/attachment_folders | |
| Type | POST | |
| Params: | api_key | required |
| file | required | |
| update_existing | optional (default = false) | |
| validate_only | optional (default = false) | |
| Response | JSON | |
JSON As Body
| Create Job - JSON | ||
|---|---|---|
| URL | http://:base_url/:api_path/:version/companies/company/attachment_folders | |
| Type | POST | |
| JSON {key, validate_only(optional), update_existing(optional), folders[]} |
required | |
| Response | JSON | |
JSON Contents
| Field | Expected Data | Required |
|---|---|---|
| name | varchar(45) | ✓ |
| order_position | int(4) | ✓ |
| folder_key | varchar(45) | ✓ |
| notes | varchar(45) |
| Standard Fields | ||
|---|---|---|
| Field | Expected Data | Required |
| key | string - company api key | ✓ |
| validate_only | boolean | |
| update_existing | boolean | |
Example Input
Multi Part Form Data
{"folders":[ { "name":"folder_test", "notes":"testing", "order_position":1, "folder_key":"folder_key" } ]}
JSON As Body
{ "key":"api_key", "validate_only":"false", "update_existing":true, "folders":[ { "name":"folder_test", "notes":"testing", "order_position":1, "folder_key":"folder_key" } ] }
Example Curl Requests
Multi Part Form Data
curl -F validate_only=false -F update_existing=true -F api_key=[YOUR_API_KEY] -F job_number=123 -F file=@/Users/darrenatherton/Desktop/webAPICurling/create_job_item_stage.txt http://api.mymobileworkers.com:8080/api/1/jobs/job/items
JSON As Body
curl -X POST -H "Content-Type: application/json" -d '{"key":"YOUR_API_KEY","job_number":"123","items":[{"type":"C","expected_quantity":"4","other":"test","notes":"exampleNotes","name":"darrenItem"}]}' http://api.mymobileworkers.com:8080/api/1/jobs/job/items
Responses
Example JSON
{ "result":"failed", "failed":[ { "item":{ "name":"item2", "type":null, "notes":null, }, "errors":[ { "error_code":"JBI002", "error_message":"Job item type is null" } ] } ], "valid":[ { "name":"item1", "type":"C", "notes":"notes", "barcodes":"barcode,barcode1" } ] }
