Compartir a través de

Términos del servicio

  • Artículo

Nota:

Este servicio está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft.

Este servicio se usa para registrar la aceptación por parte del miembro de Tango de los términos de uso del servicio tango. Aunque este servicio se creó para admitir una necesidad actual de Tango, puede usarse en el futuro para otras necesidades de servicio.

API de REST

Http (método) Endpoint Description
POST https://api.appnexus.com/terms-of-service
(add_TOS JSON)		 Agregue un nuevo registro de aceptación de términos de servicio.
GET https://api.appnexus.com/terms-of-service Ver todos los registros de términos de servicio.
GET https://api.appnexus.com/terms-of-service?id=TERMS_OF_SERVICE_ID Vea un registro de términos de servicio específico.
GET https://api.appnexus.com/terms-of-service/meta Averigüe por qué campos puede filtrar y ordenar.

Nota:

Las llamadas siguientes solo son visibles para los empleados de Xandr. Estas llamadas solo se pueden hacer mis administradores.

Http (método) Endpoint Description
PUT https://api.appnexus.com/terms-of-service?id=TERMS_OF_SERVICE_ID
(modify_TOS JSON)		 Modifique un registro de términos de servicio.
DELETE https://api.appnexus.com/terms-of-service?id=TERMS_OF_SERVICE_ID Elimine un registro de términos de servicio.

Campos JSON

Campo Tipo Description
id Entero Identificador del registro de términos de servicio.

Valor predeterminado: número generado automáticamente
user_id Entero Identificador del usuario que ha aceptado los términos de servicio.

Valor predeterminado: null
Obligatorio activado: POST
terms_name string Nombre de los términos de servicio que se aceptaron. Actualmente, esto solo debe ser términos de servicio relacionados con Tango.

Obligatorio activado: POST
date_accepted date La fecha en que se aceptaron los términos de servicio.

Obligatorio activado: POST
last_modified string Fecha de la última modificación del registro.

Ejemplos

Adición de un registro de los términos de servicio aceptados

$ 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"
    },
  }
}

Ver todos los registros de términos de servicio

$ 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"
      }
    ],
  }
}

Ver un registro de términos de servicio específico

$ 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"
    },
  }
}

Nota:

Los ejemplos siguientes solo son visibles para los empleados de Xandr. Estas llamadas solo se pueden hacer mis administradores.

Modificación de un registro de términos de servicio

$ 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"
    },
  }
}

Eliminación de un registro de términos de servicio

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