tags/get

Description

get all tags of the authenticated user

HTTP Method

GET

Explorer

Try in the explorer

Parameters

NameTypeRequiredDescription
fromnumbernouse a previous returned pos value. Output will then only contained the tags that since have changed their favorite/other status

Returns

{
  "favorite": {
    "a favorite tag": "number of times the tag is used"
  },
  "other": {
    "a non-favorite tag": "number of times the tag is used"
  },
  "pos": "the current position. remember and use later with 'from' (see above)"
}

Example

Consider a user with only 1 thing in his thinkery with the tags todo and test.

GET /v1/tags/get HTTP/1.1
Host: api.thinkery.me
Authorization: access-token=the-token-you-received

{
  "other": {
    "test": 1,
    "todo": 1
  },
  "pos": 1
}

User had made (in the web interface) tag todo a favorite tag.

GET /v1/tags/get?from=1 HTTP/1.1
Host: api.thinkery.me
Authorization: access-token=the-token-you-received

{
  "favorite": {
    "todo": 1
  },
  "pos": 2
}

On the other hand:

GET /v1/tags/get HTTP/1.1
Host: api.thinkery.me
Authorization: access-token=the-token-you-received

{
  "favorite": {
    "todo": 1
  },
  "other": {
    "test": 1
  },
  "pos": 2
}
tags/get in the API explorer