域管理 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时，在请求字符串中设置这些选项。 请参阅可选参数。

响应

成功的响应会返回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"
    }
]