XOMNI: Experience Omni-Channel

Last Updated: February 19, 2016

This API returns a list of key/value metadata pairs for a particular tag. The metadata may be used to store contextual and optional data about a tag.

Request

HTTP Method Resource URI
GET https://{tenantName}.api.xomni.com/catalog/tagmetadata?tagId={tagId}

URI Parameters

Parameter Name Description Type Conditions
tagId The unique ID of the tag. Number

Request Headers

Header Field Name Description
Accept
Includes minor version header.
Sample: application/vnd.xomni.api-v4-0, */*
Authorization
Access or identity token taken from oauth APIs.
Sample: Bearer dc8f1dcdbe454da8a25621839a93569337522968019e4bd7becd6e01285444da

Response

{
    "Data": [
        {
            "Key": "tagmetadatakey0",
            "Value": "tagmetadatavalue0"
        },
        {
            "Key": "tagmetadatakey1",
            "Value": "tagmetadatavalue1"
        },
	{
            "Key": "tagmetadatakey6",
            "Value": "tagmetadatavalue6"
        }
    ]
}

Response Body Description

Parameter Name Description Type
Data[0..N].Key The key for the metadata. String
Data[0..N].Value The value of the metadata. String

Response Headers

Header Field Name Description
Content-Type
Content type of the response entity. The value of this header is always application/json.

Status Codes

A successful operation returns status code 200 (OK) for GET operations. Possible response status codes are as listed below:

Status Code Description
400 (Bad Request) TagId is malformed.
404 (Not Found) Given tag not found.
404 (Not Found) No metadata found for given tag.