網域管理 API 方法

上次更新: 2023-05-21
  • 主題:
  • API
    檢視有關此主題的更多資訊

域管理方法,用於建立和管理要向其發送資料的域(僅適用於Cookie目標)。

建立新域

A POST 用於為(僅cookie目標)建立新域的方法。

請求

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

範例要求

{
   "url":"example1.com"
}

回應

成功的響應返回 201 created 以及合作夥伴站點,包括其唯一ID。

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

刪除域

A DELETE 用於刪除域(僅用於cookie目標)的方法。

請求

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

回應

成功的響應返回 204 no content。 返回 404 not found 找不到合作夥伴站點。

返回域的屬性

A GET 返回有關指定域的詳細資訊的方法(僅適用於cookie目標)。

請求

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

回應

成功的響應返回 200 OK 和以下示例中所示的資料。 返回 404 Not found 找不到站點ID或合作夥伴。

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

返回所有域的屬性

A 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 和陣列中的資料,如下例所示。 返回 404 Not found 找不到站點ID或合作夥伴。

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

此頁面上的