Partager via


Service des conditions générales

Remarque

Ce service est actuellement disponible pour un ensemble limité de clients et d’employés Microsoft uniquement.

Ce service est utilisé pour enregistrer l’acceptation par le membre Tango des conditions d’utilisation de Tango. Bien que ce service ait été créé pour prendre en charge un besoin tango actuel, il peut être utilisé à l’avenir pour d’autres besoins de conditions de service.

API REST

HTTP, méthode Endpoint Description
POST https://api.appnexus.com/terms-of-service
(add_TOS JSON)
Ajoutez un nouvel enregistrement d’acceptation des conditions d’utilisation du service.
GET https://api.appnexus.com/terms-of-service Afficher tous les enregistrements des conditions d’utilisation du service.
GET https://api.appnexus.com/terms-of-service?id=TERMS_OF_SERVICE_ID Afficher un enregistrement spécifique des conditions d’utilisation du service.
GET https://api.appnexus.com/terms-of-service/meta Découvrez les champs que vous pouvez filtrer et trier.

Remarque

Les appels ci-dessous sont visibles par les employés Xandr uniquement. Ces appels ne peuvent être effectués que par mes administrateurs.

HTTP, méthode Endpoint Description
PUT https://api.appnexus.com/terms-of-service?id=TERMS_OF_SERVICE_ID
(modify_TOS JSON)
Modifier un enregistrement de conditions d’utilisation du service.
DELETE https://api.appnexus.com/terms-of-service?id=TERMS_OF_SERVICE_ID Supprimer un enregistrement de conditions d’utilisation du service.

Champs JSON

Champ Type Description
id int ID de l’enregistrement des conditions d’utilisation du service.

Par défaut : nombre généré automatiquement
user_id int ID de l’utilisateur qui a accepté les conditions d’utilisation du service.

Par défaut : null
Obligatoire sur : POST
terms_name string Nom des conditions d’utilisation qui ont été acceptées. Actuellement, il ne doit s’agir que des conditions d’utilisation liées à Tango.

Obligatoire sur : POST
date_accepted date Date à laquelle les conditions d’utilisation du service ont été acceptées.

Obligatoire sur : POST
last_modified string Date de la dernière modification de l’enregistrement.

Exemples

Ajouter un enregistrement des conditions d’utilisation de service acceptées

$ cat add_TOS
{
 "terms_of_service":
  {
    "user_id" : 1066,
    "terms_name" : "Test Terms",
    "date_accepted" : "2013-01-16 00:10:00"
  }
}
$ curl -b cookies -c cookies -X POST -d @add_TOS.json "https://api.appnexus.com/terms-of-service"
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": 19,
    "terms_of_service": {
      "id": 19,
      "user_id": 1066,
      "terms_name": "Test Terms",
      "date_accepted": "2013-01-16 00:10:00",
      "last_modified": "2013-10-09 15:43:53"
    },
  }
}

Afficher tous les enregistrements des conditions d’utilisation du service

$ curl -b cookies -c cookies "http://sand.api.appnexus.com/terms-of-service"
{
  "response": {
    "status": "OK",
    "count": 8,
    "terms_of_services": [
      {
        "id": 1,
        "user_id": 3920,
        "terms_name": "",
        "date_accepted": "0000-00-00 00:00:00",
        "last_modified": "2013-10-01 21:31:45"
      },
      {
        "id": 5,
        "user_id": 3920,
        "terms_name": "\"hey\"",
        "date_accepted": "2013-10-02 00:00:00",
        "last_modified": "2013-10-01 21:35:10"
      },
      {
        "id": 6,
        "user_id": 3920,
        "terms_name": "v1",
        "date_accepted": "0000-00-00 00:00:00",
        "last_modified": "2013-10-01 22:20:44"
      },
      {
        "id": 11,
        "user_id": 3920,
        "terms_name": "\"v1\"",
        "date_accepted": "0000-00-00 00:00:00",
        "last_modified": "2013-10-01 22:37:09"
      },
      {
        "id": 16,
        "user_id": 5870,
        "terms_name": "hey",
        "date_accepted": "2013-10-01 00:00:00",
        "last_modified": "2013-10-03 19:11:34"
      },
      {
        "id": 17,
        "user_id": 5870,
        "terms_name": "v1",
        "date_accepted": "2013-10-01 00:00:00",
        "last_modified": "2013-10-03 19:19:12"
      },
      {
        "id": 18,
        "user_id": 5870,
        "terms_name": "v0",
        "date_accepted": "2013-10-03 17:10:40",
        "last_modified": "2013-10-04 00:22:40"
      },
      {
        "id": 19,
        "user_id": 1066,
        "terms_name": "Test Terms",
        "date_accepted": "2013-01-16 00:10:00",
        "last_modified": "2013-10-09 15:43:53"
      }
    ],
  }
}

Afficher un enregistrement spécifique des conditions d’utilisation du service

$ curl -b cookies -c cookies "https://api.appnexus.com/terms-of-service?id=19"
{
  "response": {
    "status": "OK",
    "count": 1,
    "terms_of_service": {
      "id": 19,
      "user_id": 1066,
      "terms_name": "Test Terms",
      "date_accepted": "2013-01-16 00:10:00",
      "last_modified": "2013-10-09 15:43:53"
    },
  }
}

Remarque

Les exemples ci-dessous sont visibles uniquement par les employés de Xandr. Ces appels ne peuvent être effectués que par mes administrateurs.

Modifier un enregistrement de conditions d’utilisation du service

$ cat modify_TOS
{
 "terms_of_service":
  {
    "terms_name" : "Usage Terms of Service"
  }
}
$ curl -b cookies -c cookies -X PUT -d @modify_TOS.json "https://api.appnexus.com/terms-of-service?id=19"
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": 19,
    "terms_of_service": {
      "id": 19,
      "user_id": 1066,
      "terms_name": "Usage Terms of Service",
      "date_accepted": "2013-01-16 00:10:00",
      "last_modified": "2013-10-09 15:43:53"
    },
  }
}

Supprimer un enregistrement de conditions d’utilisation du service

$ curl -b cookies -c cookies -X DELETE "https://api.appnexus.com/terms-of-service?id=19"
{
  "response": {
    "status": "OK",
    "count": 1,
  }
}