2017-12-08 17:41:48 +00:00
|
|
|
# Tainacan Application Programming Interface
|
|
|
|
|
|
|
|
### Brief Description
|
|
|
|
|
|
|
|
A REST API for Tainacan Plugin. This API uses the Wordpress REST API.
|
|
|
|
|
|
|
|
### Routes and Endpoints
|
|
|
|
|
|
|
|
#### Collections
|
|
|
|
|
|
|
|
1. Route `wp-json/tainacan/v2/collections/(?P<collection_id>[\d]+)`
|
|
|
|
|
|
|
|
1.1. Endpoints supported:
|
|
|
|
|
|
|
|
1.1.1 GET (Fetch a collection)
|
|
|
|
|
|
|
|
1.1.2 DELETE (Delete or Trash a collection and all your dependencies)
|
2017-12-11 17:05:09 +00:00
|
|
|
|
2017-12-08 17:41:48 +00:00
|
|
|
```
|
|
|
|
To delete pass in body of a requisition the parameter is_permanently as true.
|
|
|
|
To only trash pass false.
|
|
|
|
```
|
|
|
|
2. Route `wp-json/tainacan/v2/collections`
|
|
|
|
|
|
|
|
2.1. Endpoints supported:
|
|
|
|
|
|
|
|
2.1.1 GET (Fetch all collections)
|
|
|
|
|
|
|
|
2.1.2 POST (Create a collection).
|
|
|
|
|
|
|
|
#### Items
|
|
|
|
|
|
|
|
1. Route `wp-json/tainacan/v2/items/collection/(?P<collection_id>[\d]+)`
|
|
|
|
|
|
|
|
1.1. Endpoints supported:
|
|
|
|
|
|
|
|
1.1.1 GET (Fetch all items from a collection)
|
|
|
|
|
|
|
|
1.1.2 POST (Create a item in a collection)
|
|
|
|
|
|
|
|
2. Route `wp-json/tainacan/v2/items/(?P<item_id>[\d]+)`
|
|
|
|
|
|
|
|
2.1. Endpoints supported:
|
|
|
|
|
|
|
|
2.1.1 GET (Fetch a item)
|
|
|
|
|
|
|
|
2.1.2 DELETE (Delete or Trash a item and all your dependencies)
|
2017-12-11 17:05:09 +00:00
|
|
|
|
2017-12-08 17:41:48 +00:00
|
|
|
```
|
|
|
|
To delete pass in body of a requisition the parameter is_permanently as true.
|
|
|
|
To only trash pass false.
|
|
|
|
```
|
2017-12-11 17:05:09 +00:00
|
|
|
|
|
|
|
#### Metadata
|
|
|
|
|
|
|
|
1. Route `wp-json/tainacan/v2/metadata/collection/(?P<collection_id>[\d]+)`
|
|
|
|
|
|
|
|
1.1. Endpoints supported:
|
|
|
|
|
|
|
|
1.1.1 POST (Create a metadata in collection and all your items)
|
|
|
|
|
|
|
|
```
|
|
|
|
In body of requisition pass a JSON with the attributes of metadata like:
|
|
|
|
```
|
|
|
|
|
|
|
|
```javascript
|
|
|
|
{
|
|
|
|
name: '',
|
|
|
|
description: '',
|
|
|
|
field_type: ''
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
2017-12-12 17:33:36 +00:00
|
|
|
1.1.2 GET (Fetch all collection metadata)
|
|
|
|
|
2017-12-11 17:05:09 +00:00
|
|
|
2. Route `wp-json/tainacan/v2/metadata/item/(?P<item_id>[\d]+)`
|
|
|
|
|
|
|
|
2.1. Endpoints supported:
|
|
|
|
|
|
|
|
2.1.1 POST (Set a value of item metadata)
|
|
|
|
|
|
|
|
```
|
|
|
|
In body of requisition pass a JSON with value e and id of metadata like:
|
|
|
|
```
|
|
|
|
|
|
|
|
```javascript
|
|
|
|
{
|
|
|
|
metadata_id: '',
|
|
|
|
values: ''
|
|
|
|
}
|
|
|
|
|
2017-12-12 17:33:36 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
2.1.2 GET (Fetch all item metadata, with your values)
|