Tags
Tags are hash-prefixed keywords or phrases that appear in the title, description, or comments of a dataset. Tags can be used to index datasets by their contained tags with a search, which allows for topical dataset categorisation.
Objects
Tag
| Path | Type | Format | Description |
|---|---|---|---|
id |
String |
Version 4 UUID | The tag ID |
name |
String |
The tag name | |
usage |
Integer |
Unsigned | Number of times the tag is used within the workspace |
{
"id" : "ddf8c8e1-3279-425f-a53a-a9d0dd1e9d61",
"name" : "fantastic",
"usage" : 1,
"_links" : {
"self" : {
"href" : "https://catalog.matatika.com/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/tags/ddf8c8e1-3279-425f-a53a-a9d0dd1e9d61"
},
"search" : {
"href" : "https://catalog.matatika.com/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/search?q=tag:fantastic"
}
}
}
Requests
See Also
View all tags in a workspace
GET
/api/workspaces/{workspace-id}/tags
Returns all tags in the workspace {workspace-id}.
Prerequisites
- Workspace
{workspace-id}must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://catalog.matatika.com:443/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/tags' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests)
import requests
url = "https://catalog.matatika.com:443/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/tags"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Tag collection with HAL links.
{
"_embedded" : {
"tags" : [ {
"id" : "ddf8c8e1-3279-425f-a53a-a9d0dd1e9d61",
"name" : "fantastic",
"usage" : 1,
"_links" : {
"self" : {
"href" : "https://catalog.matatika.com/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/tags/ddf8c8e1-3279-425f-a53a-a9d0dd1e9d61"
},
"search" : {
"href" : "https://catalog.matatika.com/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/search?q=tag:fantastic"
}
}
}, {
"id" : "e84beb78-79f9-438d-af75-84cc08d7e676",
"name" : "postgres",
"usage" : 1,
"_links" : {
"self" : {
"href" : "https://catalog.matatika.com/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/tags/e84beb78-79f9-438d-af75-84cc08d7e676"
},
"search" : {
"href" : "https://catalog.matatika.com/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/search?q=tag:postgres"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://catalog.matatika.com/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/tags"
}
}
}
View all tags in the news for a workspace
GET
/api/workspaces/{workspace-id}/news/tags
Returns all tags in the news for the workspace {workspace-id}.
Prerequisites
- Workspace
{workspace-id}must exist
Response
200 OK
Tag collection with HAL links.
View a tag in a workspace
GET
/api/workspaces/{workspace-id}/tags/{tag-id}
Returns the tag {tag-id} in the workspace {workspace-id}.
Prerequisites
- Workspace
{workspace-id}must exist - Tag
{tag-id}must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://catalog.matatika.com:443/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/tags/ddf8c8e1-3279-425f-a53a-a9d0dd1e9d61' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests)
import requests
url = "https://catalog.matatika.com:443/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/tags/ddf8c8e1-3279-425f-a53a-a9d0dd1e9d61"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Tag with HAL links.
{
"id" : "ddf8c8e1-3279-425f-a53a-a9d0dd1e9d61",
"name" : "fantastic",
"usage" : 1,
"_links" : {
"self" : {
"href" : "https://catalog.matatika.com/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/tags/ddf8c8e1-3279-425f-a53a-a9d0dd1e9d61"
},
"search" : {
"href" : "https://catalog.matatika.com/api/workspaces/0f3e5cc2-287f-431d-a964-a1d086ae9b4a/search?q=tag:fantastic"
}
}
}