Skip to main content

Datatags

The datatag concept is described here.

tip

Need some changes ? More endpoints ? Please open a github issue or contact us at love@misakey.com.

Introduction#

Concept#

Datatags are used to identify data shipped through Misakey channels.

They are simple strings defining a data type, they are defined by Misakey, more datatags of your choice can be created by contacting us.

Datatags#


List datatags#

Request#

GET https://api.misakey.com/datatags?names=
Authorizations#
Cookies:
  • accesstoken (opaque token) (ACR >= 2): mid claim as the requested identity id.
  • tokentype (string): must be bearer.
Headers:
  • X-CSRF-Token: a token to prevent from CSRF attacks.

Query Parameters:

  • names (optional) (comma-separated list of string): names of datatag.
  • name (optional) (string): name of datatag (it is added to names parameter in case of both parameter are found).

Response#

An empty list is returned if no datatag has been found.

HTTP 200 OK

JSON Body:

[
{
"id": "c3fde689-5d4e-4f1b-813f-f9cdb05547ce",
"name": "purchase",
"created_at": "2021-03-10T14:14:03.76932Z"
}
]

List datatags concerning a given user in a given organization#

Request#

GET https://api.misakey.com/identities/:id/datatags
Authorizations#
Cookies:
  • accesstoken (opaque token) (ACR >= 2): mid claim as the requested identity id.
  • tokentype (string): must be bearer.
Headers:
  • X-CSRF-Token: a token to prevent from CSRF attacks.
Path parameter#
  • id: the unique id of your identity

Success response#

Code#
HTTP 200 OK
Response Body#

An array of datatags. An empty array is returned if nothing has been found.

Content-type: application/json

[
{
"id": "64c68e09-bb33-4d48-9b2c-a4a40e5054ce",
"name": "Orders",
"created_at": "2020-08-05T16:02:22.104236Z"
}
]