Métodos da API de gerenciamento de domínio

Métodos de gerenciamento de domínio que permitem criar e gerenciar os domínios para os quais deseja enviar dados (somente para destinos de cookies).

Criar um novo domínio

Um método POST que permite criar um novo domínio para (somente destinos de cookie).

Solicitação

POST https://api.demdex.com/v1/partner-sites/

Solicitação de exemplo

{
   "url":"example1.com"
}

Resposta

Uma resposta bem-sucedida retorna 201 created e o site parceiro, incluindo sua ID exclusiva.

{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Excluir um domínio

Um método DELETE que permite remover um domínio (somente para destinos de cookies).

Solicitação

DELETE https://api.demdex.com/v1/partner-sites/<site-Id>

Resposta

Uma resposta bem-sucedida retorna 204 no content. Retorna 404 not found se o site parceiro não puder ser encontrado.

Retornar propriedades para um domínio

Um método GET que retorna detalhes sobre o domínio especificado (somente para destinos de cookie).

Solicitação

GET https://api.demdex.com/v1/partner-sites/<siteId>

Resposta

Uma resposta bem-sucedida retorna 200 OK e os dados, como mostrado na amostra abaixo. Retorna 404 Not found se a ID do site ou o parceiro não for encontrado.

{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Retornar propriedades para todos os domínios

Um método GET que retorna informações sobre todos os domínios (somente para destinos de cookies).

Solicitação

GET https://api.demdex.com/v1/partner-sites/

Parâmetros de consulta opcionais

Você pode usar esses parâmetros opcionais com métodos API que retornam todas propriedades para um objeto. Defina essas opções na cadeia de caracteres de solicitação ao passar essa consulta para API. Consulte Parâmetros opcionais.

Parâmetro Descrição
page Retorna os resultados por número de página. A numeração começa em 0.
pageSize Define o número de resultados de resposta retornados pela solicitação (10 é o padrão).
sortBy Classifica e retorna resultados de acordo com a propriedade JSON especificada.
descending Classifica e retorna resultados em ordem decrescente. Crescente é padrão.
search Retorna resultados com base na string especificada que você deseja usar como parâmetro de pesquisa. Por exemplo, digamos que você queira encontrar resultados para todos os modelos que têm a palavra "Teste" em qualquer um dos campos de valor para esse item. Sua solicitação de amostra pode ter esta aparência:

`GET` `https://api.demdex.com/v1/models/?search=Test`.

Você pode pesquisar qualquer valor retornado por um método "obter tudo".

Resposta

Uma resposta bem-sucedida retorna 200 OK e os dados em uma matriz, como mostrado na amostra abaixo. Retorna 404 Not found se a ID do site ou o parceiro não for encontrado.

[
    {
        "pid": 1111,
        "siteId": 111,
        "url": "example1.com"
    },
    {
        "pid": 2222,
        "siteId": 222,
        "url": "example2.com"
    },
    {
        "pid": 3333,
        "siteId": 333,
        "url": "example3.com"
    }
]

Nesta página