Overview

Resources

Tag Resource

This resource represents tag inside of an tag store.

Available HTTP-Methods for Tag Resource


PUT - Tag Resource

PUT - Url

.../tags/ID?_method=PUT

PUT - Attributes

Attributes are part of the entity send or requested.

TypeNameDescription
stringdefaultName (mandatory)This is the name of tag.
stringdescriptionThis is the description of tag.
stringlanguageCodeThis is the language code of tag.
stringnameThis is the name of tag.
booleanrenameTagIf set, it is only possible to edit the default name. Also only managers and system users may use this.
longtagIdIs the identifier of the tag.
stringtagStoreAliasThis is the identifier of the tagstore.
stringtagStoreTagIdThis is the identifier of tag inside tagstore.
stringtagStoreTypeType of tag store (BLOG, NOTE, ENTITY). Default type is NOTE.

GET - Tag Resource

By sending a HTTP-GET request, the server returns the requested the specified tag resource. There are two ways to get the tag. When the tag identifier in the url was set, the api search for this tag in the database. But when the tag identifier is set 0 then tagStoreTagId and tagStoreAlias must been specified to find the tag.

Please notice the documentation for Resources Tunneling, if you encounter any problems invoking get requests on your server.

GET - Url

.../tags/ID

GET - Attributes

Attributes are part of the entity send or requested.

TypeNameDescription
stringdefaultNameThis is the name of tag.
stringdescriptionThis is the description of tag.
booleanisFollowIndicates whether the topic is followed by the user.
stringlanguageCodeThis is the language code of tag.
stringnameThis is the name of tag.
longtagIdIs the identifier of the tag.
stringtagStoreAliasThis is the identifier of the tagstore.
stringtagStoreTagIdThis is the identifier of tag inside tagstore.

LIST - Tag Resource

LIST - Url

.../tags/

LIST - Attributes

Attributes are part of the entity send or requested.

TypeNameDescription
booleanisFollowIndicates whether the topic is followed by the user.

DELETE - Tag Resource

DELETE - Url

.../tags/ID?_method=DELETE

DELETE - Attributes

Attributes are part of the entity send or requested.

TypeNameDescription
longnewTagIdUsed, when a tag is removed to assing all notes to the new tag.
longtagIdIs the identifier of the tag.