API-Methoden für die Domänenverwaltung

Domain-Verwaltungsmethoden, mit denen Sie die Domänen erstellen und verwalten können, an die Sie Daten senden möchten (nur für Cookie-Ziele).

Neue Domäne erstellen

Eine POST -Methode, mit der Sie eine neue Domäne für erstellen können (nur Cookie-Ziele).

Anfrage

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

Beispielanforderung

{
   "url":"example1.com"
}

Antwort

Eine erfolgreiche Antwort gibt 201 created und die Partner-Site zurück, einschließlich der eindeutigen ID.

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

Löschen einer Domäne

Eine DELETE -Methode, mit der Sie eine Domäne entfernen können (nur für Cookie-Ziele).

Anfrage

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

Antwort

Eine erfolgreiche Antwort gibt 204 no content zurück. Gibt 404 not found zurück, wenn die Partner-Site nicht gefunden werden kann.

Eigenschaften für eine Domäne zurückgeben

Eine GET -Methode, die Details zur angegebenen Domäne zurückgibt (nur für Cookie-Ziele).

Anfrage

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

Antwort

Eine erfolgreiche Antwort gibt 200 OK und -Daten zurück, wie im folgenden Beispiel gezeigt. Gibt 404 Not found zurück, wenn die Site-ID oder der Partner nicht gefunden wurde.

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

Rückgabeeigenschaften für alle Domänen

Eine GET -Methode, die Informationen über alle Ihre Domänen zurückgibt (nur für Cookie-Ziele).

Anfrage

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

Optionale Abfrageparameter

Sie können diese optionalen Parameter mit API-Methoden verwenden, die alle-Eigenschaften für ein Objekt zurückgeben. Legen Sie diese Optionen in der Anforderungszeichenfolge fest, wenn Sie diese Abfrage an API übergeben. Siehe Optionale Parameter.

Parameter Beschreibung
page Gibt Ergebnisse nach Seitenzahl zurück. Die Nummerierung beginnt bei 0.
pageSize Legt die Anzahl der von der Anfrage zurückgegebenen Antwortergebnisse fest (standardmäßig 10).
sortBy Sortiert Ergebnisse und gibt sie gemäß der angegebenen JSON-Eigenschaft zurück.
descending Sortiert Ergebnisse und gibt sie in absteigender Reihenfolge zurück. Aufsteigend ist die Standardeinstellung.
search Gibt Ergebnisse basierend auf der angegebenen Zeichenfolge zurück, die Sie als Suchparameter verwenden möchten. Angenommen, Sie möchten Ergebnisse für alle Modelle mit dem Wort "Test"in einem der Wertefelder für dieses Element finden. Ihre Beispielanfrage könnte wie folgt aussehen:

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

Sie können nach jedem Wert suchen, der von einer "get all"-Methode zurückgegeben wird.

Antwort

Eine erfolgreiche Antwort gibt 200 OK und Daten in einem Array zurück, wie im folgenden Beispiel gezeigt. Gibt 404 Not found zurück, wenn die Site-ID oder der Partner nicht gefunden wurde.

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

Auf dieser Seite