域管理API方法 domain-management-api-methods

域管理方法允许您创建和管理要将数据发送到的域（仅适用于Cookie目标）。

创建新域 create-new-domain

一种POST方法，可让您为（仅限Cookie目标）创建新域。

请求

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

示例请求

{
   "url":"example1.com"
}

响应

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

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

删除域 delete-domain

允许您删除域的DELETE方法（仅适用于Cookie目标）。

请求

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

响应

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

返回域的属性 return-props-domain

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

请求

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

响应

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

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

返回所有域的属性 return-props-all-domains

用于返回所有域相关信息的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"
    }
]