API-Methoden für die Domänenverwaltung domain-management-api-methods
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 create-new-domain
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
Bei einer erfolgreichen Antwort werden 201 created
und die Partner-Site zurückgegeben, einschließlich der eindeutigen ID.
{
"pid": 1111,
"siteId": 111,
"url": "example1.com"
}
Löschen einer Domäne delete-domain
Eine DELETE
-Methode zum Entfernen einer Domäne (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 return-props-domain
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 return-props-all-domains
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 den API übergeben. Siehe Optionale Parameter.
page
pageSize
sortBy
descending
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 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"
}
]