Show Menu
SUJETS×

Méthodes d’API de gestion de domaine

Méthodes de gestion des domaines qui vous permettent de créer et de gérer les domaines auxquels vous souhaitez envoyer des données (pour les destinations de cookies uniquement).

Create a New Domain

Méthode POST permettant de créer un nouveau domaine pour (destinations de cookies uniquement).

Demande

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

Exemple de requête

{
   "url":"example1.com"
}

Réponse

Une réponse positive est renvoyée 201 created et le site partenaire, y compris son identifiant unique.
{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Suppression d’un domaine

Méthode DELETE permettant de supprimer un domaine (pour les destinations de cookies uniquement).

Demande

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

Réponse

Une réponse réussie revient 204 no content . Renvoie 404 not found si le site partenaire est introuvable.

Propriétés de retour pour un domaine

Méthode GET qui renvoie des détails sur le domaine spécifié (pour les destinations de cookies uniquement).

Demande

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

Réponse

Une réponse réussie renvoie 200 OK des données comme le montre l'exemple ci-dessous. Renvoie 404 Not found si l'identifiant ou le partenaire du site est introuvable.
{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Propriétés de retour pour tous les domaines

Méthode GET qui renvoie des informations sur tous vos domaines (pour les destinations de cookies uniquement).

Demande

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

Paramètres de Requête facultatifs

Vous pouvez utiliser ces paramètres facultatifs avec API des méthodes qui renvoient toutes les propriétés d’un objet. Définissez ces options dans la chaîne de requête lors de la transmission de cette requête à la API. Voir Paramètres Paramètres API de Requête facultatifs facultatifs.
Paramètre Description
page Renvoie les résultats par numéro de page. débuts de numérotation à 0.
pageSize Définit le nombre de résultats de réponse renvoyés par la requête (10 est la valeur par défaut).
sortBy Trie et renvoie les résultats selon la propriété JSON spécifiée.
descending Trie et renvoie les résultats dans l’ordre décroissant. Ascendant est défini par défaut.
search Renvoie des résultats basés sur la chaîne spécifiée que vous souhaitez utiliser comme paramètre de recherche. Supposons, par exemple, que vous souhaitiez trouver des résultats pour tous les modèles qui contiennent le mot "Test" dans l’un des champs de valeur de cet élément. Votre exemple de demande peut se présenter comme suit :
`GET` `https://api.demdex.com/v1/models/?search=Test` .
Vous pouvez rechercher n’importe quelle valeur renvoyée par une méthode "get all".

Réponse

Une réponse réussie renvoie 200 OK et des données dans un tableau, comme le montre l'exemple ci-dessous. Renvoie 404 Not found si l'identifiant ou le partenaire du site est introuvable.
[
    {
        "pid": 1111,
        "siteId": 111,
        "url": "example1.com"
    },
    {
        "pid": 2222,
        "siteId": 222,
        "url": "example2.com"
    },
    {
        "pid": 3333,
        "siteId": 333,
        "url": "example3.com"
    }
]