API-Methoden für die Domänenverwaltung

Domänenverwaltungsmethoden, 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äneerstellen

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

Anfrage

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

Beispielanforderung

{
   "url":"example1.com"
}

Antwort

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

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

Eine Domänelöschen

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.

Rückgabeeigenschaften für eine Domäne

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 die Daten wie im Beispiel unten dargestellt zurück. 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 Abfrage-Parameter

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 diese Abfrage an das API übergeben wird. Siehe Optionale Parameter.

Parameter Beschreibung
page Gibt Ergebnisse nach Seitenzahl zurück. Nummerierung von Beginn bei 0.
pageSize Legt die Anzahl der Antwortergebnisse fest, die von der Anforderung zurückgegeben werden (10 ist standardmäßig).
sortBy Sortiert Ergebnisse und gibt sie entsprechend der angegebenen JSON-Eigenschaft zurück.
descending Sortiert die Ergebnisse und gibt sie in absteigender Reihenfolge zurück. Aufsteigend ist der Standardwert.
search Gibt Ergebnisse basierend auf der angegebenen Zeichenfolge zurück, die Sie als Suchparameter verwenden möchten. Nehmen wir beispielsweise an, Sie möchten Ergebnisse für alle Modelle suchen, die das Wort "Test"in einem der Wertefelder für dieses Element enthalten. Ihre Musteranforderung könnte wie folgt aussehen:

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

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

Antwort

Eine erfolgreiche Antwort gibt 200 OK und Daten in einem Array zurück, wie im Beispiel unten dargestellt. 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