Servicio Carrier Netblock

Artículo
07/05/2024

Nota:

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

Este servicio de solo administrador se puede usar para asignar bloques de direcciones IP a proveedores de Internet, lo que permite a los anunciantes con campañas móviles dirigirse a proveedores de Internet específicos.

API de REST

Http (método)	Endpoint	Description
`POST`	https://api.appnexus.com/carrier-netblock (add_mapping JSON)	Agregue una nueva asignación carrier-netblock.
`PUT`	https://api.appnexus.com/carrier-netblock?id=CARRIER_NETBLOCK_MAPPING_ID (update_mapping JSON)	Modifique una asignación de carrier-netblock existente.
`GET`	https://api.appnexus.com/carrier-netblock	Ver todas las asignaciones de carrier-netblock.
`GET`	https://api.appnexus.com/carrier-netblock?id=CARRIER_NETBLOCK_MAPPING_ID	Ver una asignación de carrier-netblock específica.
`DELETE`	https://api.appnexus.com/carrier-netblock?id=CARRIER_NETBLOCK_MAPPING_ID	Elimine una asignación carrier-netblock.
`GET`	https://api.appnexus.com/carrier-netblock/meta	Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

Campo	Tipo	Descripción
`id`	Entero	Identificador de la asignación carrier-netblock. Predeterminado: Número generado automáticamente. Obligatorio activado:`PUT`
`carrier_id`	Entero	El identificador del operador de Internet. Puede usar el Servicio de operador para ver la lista de operadores disponibles y sus identificadores. Obligatorio activado:`POST`
`start_ip`	Entero	La dirección IP al principio del intervalo de direcciones IP que desea asignar. Este valor debe especificarse como un entero aplanado. Convierta la dirección IP mediante una herramienta como esta para obtener un entero aplanado en `POST` o `PUT`. Obligatorio activado:`POST`
`end_ip`	Entero	La dirección IP al final del intervalo de direcciones IP que desea asignar. Convierta la dirección IP mediante una herramienta como esta para obtener un entero aplanado en `POST` o `PUT`. Obligatorio activado:`POST`
`notes`	string	Notas relevantes para la asignación carrier-netblock. Predeterminado:`null`
`last_activity`	date	Fecha y hora en que se modificó por última vez la asignación carrier-netblock.

Ejemplos

Adición de una asignación carrier-netblock

$ cat add_mapping

{
        "carrier-netblock": {
             "carrier_id": 26,
             "start_ip": "2886794753",
             "end_ip": "4294967295"                
        }
}

$ curl -b cookies -c cookies -X POST -d @add_mapping.json "https://api.appnexus.com/carrier-netblock"
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": 11829,
    "start_element": 0,
    "num_elements": 100,
    "carrier-netblock": {
      "id": 11829,
      "carrier_id": 26,
      "start_ip": 2886794753,
      "end_ip": 4294967295,
      "notes": null,
      "last_activity": "2013-09-12 13:47:04"
    },
  }
}

Actualización de una asignación de carrier-netblock

$ cat update_mapping

{
        "carrier-netblock": {
             "start_ip": "3221225471",
             "end_ip": "4294967295"               
        }
}

$ curl -b cookies -c cookies -X PUT -d @update_mapping.json "https://api.appnexus.com/carrier-netblock?id=11829"
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": "11829",
    "start_element": 0,
    "num_elements": 100,
    "carrier-netblock": {
      "id": 11829,
      "carrier_id": 26,
      "start_ip": 3221225471,
      "end_ip": 4294967295,
      "notes": null,
      "last_activity": "2013-09-12 14:55:28"
    },
  }
}

Visualización de todas las asignaciones de carrier-netblock

$ curl -b cookies -c cookies "https://api.appnexus.com/carrier-netblock"
{
  "response": {
    "status": "OK",
    "count": 6950,
    "start_element": 0,
    "num_elements": 100,
    "carrier-netblocks": [
      {
        "id": 4,
        "carrier_id": 165,
        "start_ip": 3452776960,
        "end_ip": 3452777215,
        "notes": "Seed",
        "last_activity": "2013-08-07 20:49:55"
      },
      {
        "id": 5,
        "carrier_id": 165,
        "start_ip": 3452811776,
        "end_ip": 3452812031,
        "notes": "Seed",
        "last_activity": "2013-08-07 20:49:55"
      },
      {
        "id": 6,
        "carrier_id": 165,
        "start_ip": 3517383936,
        "end_ip": 3517384191,
        "notes": "Seed",
        "last_activity": "2013-08-07 20:49:55"
      },
      {
        "id": 46,
        "carrier_id": 14,
        "start_ip": 68665344,
        "end_ip": 68665351,
        "notes": "Seed",
        "last_activity": "2012-11-27 16:11:25"
      },
      {
        "id": 48,
        "carrier_id": 14,
        "start_ip": 204593600,
        "end_ip": 204593615,
        "notes": "Seed",
        "last_activity": "2012-11-27 16:11:25"
      },
      {
        "id": 51,
        "carrier_id": 14,
        "start_ip": 214464808,
        "end_ip": 214464815,
        "notes": "Seed",
        "last_activity": "2012-11-27 16:11:25"
      },
 ...
      {
        "id": 1219,
        "carrier_id": 151,
        "start_ip": 3582880768,
        "end_ip": 3582885887,
        "notes": "Seed",
        "last_activity": "2013-05-15 15:15:00"
      },
      {
        "id": 1220,
        "carrier_id": 151,
        "start_ip": 3584180736,
        "end_ip": 3584180991,
        "notes": "Seed",
        "last_activity": "2013-05-15 15:15:00"
      },
      {
        "id": 1221,
        "carrier_id": 151,
        "start_ip": 3584181248,
        "end_ip": 3584182015,
        "notes": "Seed",
        "last_activity": "2013-05-15 15:15:00"
      },
      {
        "id": 1252,
        "carrier_id": 199,
        "start_ip": 44040192,
        "end_ip": 45088767,
        "notes": "Seed",
        "last_activity": "2013-05-15 15:18:07"
      },
      {
        "id": 1255,
        "carrier_id": 199,
        "start_ip": 1050537728,
        "end_ip": 1050537731,
        "notes": "Seed",
        "last_activity": "2013-05-15 15:18:07"
      }
    ],
  }
}

Visualización de una asignación de carrier-netblock específica

$ curl -b cookies -c cookies "https://api.appnexus.com/carrier-netblock?id=46"
{
  "response": {
    "status": "OK",
    "count": 1,
    "start_element": 0,
    "num_elements": 100,
    "carrier-netblock": {
      "id": 46,
      "carrier_id": 14,
      "start_ip": 68665344,
      "end_ip": 68665351,
      "notes": "Seed",
      "last_activity": "2012-11-27 16:11:25"
    },
  }
}

Compartir a través de