Show Menu
TÓPICOS×

Métodos da API taxonômica

Métodos que permitem exibir a taxonomia comum do Audience Manager. Este sistema de classificação opcional organiza características em categorias padrão do setor.
Não é possível criar novas categorias taxonômicas ou classificar características com esses métodos. Para classificar uma característica, especifique a apropriada categoryId com um método de criação ou atualização de característica.

Retornar uma Taxonomia Específica

Um GET método que retorna detalhes sobre a categoria taxonômica especificada.

Solicitação

GET https://api.demdex.com/v1/taxonomies/0/ <categoryId>

Resposta

Uma resposta bem-sucedida retorna 200 OK e a categoria para a ID especificada. Uma solicitação com falha retornará 404 No Content se a ID não existir.
{
    "crUID": 158,
    "name": "Arts & Entertainment",
    "upUID": 158,
    "description": "Arts & Entertainment",
    "categoryID": 1,
    "parentCategoryID": 0
}

Retornar todas as categorias taxonômicas

Um GET método que retorna uma lista das categorias de nível superior em um storage.

Solicitação

GET https://api.demdex.com/v1/taxonomies/0/

Resposta

Truncado para brevidade.
[
    {
        "crUID": 158,
        "name": "Arts & Entertainment",
        "upUID": 158,
        "description": "Arts & Entertainment",
        "categoryID": 1,
        "parentCategoryID": 0
    },
    {
        "crUID": 158,
        "name": "Automotive",
        "upUID": 158,
        "description": "Automotive",
        "categoryID": 2,
        "parentCategoryID": 0
    },
    {
        "crUID": 158,
        "name": "Business",
        "upUID": 158,
        "description": "Business",
        "categoryID": 3,
        "parentCategoryID": 0
    }
]

Subcategorias Taxonômicas de Retorno

Um GET método que retorna subcategorias para a categoria pai especificada em uma matriz.

Solicitação

GET https://api.demdex.com/v1/taxonomies/0/ <categoryId> /childCategories/

Resposta

Uma resposta bem-sucedida retorna 200 OK e a categoria para a ID especificada. Uma solicitação com falha retornará 404 No Content se a ID não existir. Truncado para brevidade.
[
    {
        "crUID": 158,
        "name": "Books & Literature",
        "upUID": 158,
        "description": "Books & Literature",
        "categoryID": 25,
        "parentCategoryID": 1
    },
    {
        "crUID": 158,
        "name": "Celebrity Fan/Gossip",
        "upUID": 158,
        "description": "Celebrity Fan/Gossip",
        "categoryID": 49,
        "parentCategoryID": 1
    },
    {
        "crUID": 158,
        "name": "Fine Art",
        "upUID": 158,
        "description": "Fine Art",
        "categoryID": 72,
        "parentCategoryID": 1
    }
]