Created Transaction Upload API (markdown)

Tom Bloor 2017-04-19 22:30:41 +01:00
parent 302037c2e2
commit 757e2ba485

56
Transaction-Upload-API.md Normal file

@ -0,0 +1,56 @@
# Transaction Upload API
_Last Updated 2017-04-19_
## `POST /api/upload`
Takes a `multipart/form-data` upload, with the following parts:
* File under the form key `file2`
* JSON Object with required arguments under `json` key
The JSON can be one of the following types:
* Known and Validated Organisation
* Known but Unvalidated Organisation
* Unknown Organisation
### Known and Validated Organisation
Request JSON
```
{
session_key : <current session key>,
transaction_type : 1,
transaction_value : 2.99,
organisation_id : <id_number>
}
```
### Known but Unvalidated Organisation
```
{
session_key : <current session key>,
transaction_type : 2,
transaction_value : 2.99,
organisation_id : <id_number>
}
```
### Unknown Organisation
```
{
session_key : <current session key>,
transaction_type : 3,
transaction_value : 2.99,
organisation_name : 'Org Name',
street_name : '7 High Street',
town : 'Lancaster',
postcode : 'LA1 1AA',
}
```
**Note** `street_name` and `postcode` are optional.