域管理 API 方法

域管理方法,用于创建和管理要向其发送数据的域(仅适用于Cookie目标)。

创建新域

POST方法,允许您为(仅限Cookie目标)创建新域。

请求

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

示例请求

{
   "url":"example1.com"
}

响应

成功的响应会返回201 created和合作伙伴网站,包括其唯一ID。

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

删除域

DELETE方法,用于删除域(仅用于Cookie目标)。

请求

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

响应

成功的响应返回204 no content。 如果找不到合作伙伴网站,则返回404 not found

返回域的属性

GET方法,可返回有关指定域的详细信息(仅适用于Cookie目标)。

请求

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

响应

成功的响应会返回200 OK和数据,如以下示例所示。 如果找不到网站ID或合作伙伴,则返回404 Not found

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

返回所有域的属性

一种GET方法,可返回有关所有域的信息(仅适用于Cookie目标)。

请求

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

可选查询参数

您可以将这些可选参数与返回对象​所有​属性的API方法一起使用。 将查询传递到API时,在请求字符串中设置这些选项。 请参阅可选参数

参数 描述
page 按页码返回结果。 编号从0开始。
pageSize 设置请求返回的响应结果数(默认为10)。
sortBy 根据指定的JSON属性对结果进行排序和返回。
descending 按降序排序和返回结果。 默认为升序。
search 根据要用作搜索参数的指定字符串返回结果。 例如,假设您希望在该项目的任何值字段中查找包含“Test”字样的所有模型的结果。 您的示例请求可能如下所示:

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

您可以搜索“get all”方法返回的任何值。

响应

成功的响应会返回200 OK和数组中的数据,如以下示例所示。 如果找不到网站ID或合作伙伴,则返回404 Not found

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

在此页面上