Tag collection¶
Read/write
This resource type refers to a collection of feed-specific tag items.
In other Collection+JSON resource representations this resource type is linked by any link relation with attribute:
"rel": "tags"
Synopsis: Gets the list of tags for the feed (feed_id). Example request:
GET /api/v1/35/tags/ HTTP/1.1 Host: localhost:8000 Accept: application/vnd.collection+json
Example response:
HTTP/1.1 200 OK Allow: GET, POST Content-Type: application/vnd.collection+json { "collection": { "href": "https://localhost:8000/api/v1/35/tags/", "items": [ { "data": [ { "name": "name", "value": "Completed" }, { "name": "owner", "value": "jbernal" }, { "name": "color", "value": "red" } ], "href": "https://localhost:8000/api/v1/tags/1/", "links": [ { "href": "https://localhost:8000/api/v1/35/", "rel": "feed" } ] } ], "links": [ { "href": "https://localhost:8000/api/v1/35/", "rel": "feed" } ], "template": { "data": [ { "name": "name", "value": "" }, { "name": "color", "value": "" } ] }, "version": "1.0" } }
Request Headers: - Accept – application/vnd.collection+json
Response Headers: - Content-Type – application/vnd.collection+json
Status Codes: - 200 OK – no error
- 401 Unauthorized – authentication credentials were not provided
- 403 Forbidden – you do not have permission to perform this action
- 404 Not Found – not found
Properties (API semantic descriptors):
- tag item properties
- tag item link relations