域管理方法,用于创建和管理要向其发送数据的域(仅适用于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 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"
}
]