Partager via


Service Carrier Netblock

Remarque

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

Ce service d’administration uniquement peut être utilisé pour mapper des blocs d’adresses IP à des fournisseurs Internet, ce qui permet aux annonceurs avec des campagnes mobiles de cibler des fournisseurs Internet spécifiques.

API REST

HTTP, méthode Endpoint Description
POST https://api.appnexus.com/carrier-netblock
(add_mapping JSON)
Ajoutez un nouveau mappage carrier-netblock.
PUT https://api.appnexus.com/carrier-netblock?id=CARRIER_NETBLOCK_MAPPING_ID
(update_mapping JSON)
Modifier un mappage carrier-netblock existant.
GET https://api.appnexus.com/carrier-netblock Affichez tous les mappages carrier-netblock.
GET https://api.appnexus.com/carrier-netblock?id=CARRIER_NETBLOCK_MAPPING_ID Afficher un mappage carrier-netblock spécifique.
DELETE https://api.appnexus.com/carrier-netblock?id=CARRIER_NETBLOCK_MAPPING_ID Supprimer un mappage carrier-netblock.
GET https://api.appnexus.com/carrier-netblock/meta Découvrez les champs que vous pouvez filtrer et trier.

Champs JSON

Champ Type Description
id int ID du mappage carrier-netblock.
Par défaut: Nombre généré automatiquement.
Obligatoire sur :PUT
carrier_id int ID de l’opérateur Internet. Vous pouvez utiliser le service opérateur pour afficher la liste des opérateurs disponibles et leurs ID.
Obligatoire sur :POST
start_ip int Adresse IP au début de la plage d’adresses IP que vous souhaitez mapper. Cette valeur doit être entrée sous la forme d’un entier aplatissement. Convertissez l’adresse IP à l’aide d’un outil tel que celui-ci, afin d’obtenir un entier aplati en POST ou PUT.
Obligatoire sur :POST
end_ip int Adresse IP à la fin de la plage d’adresses IP que vous souhaitez mapper. Convertissez l’adresse IP à l’aide d’un outil tel que celui-ci, afin d’obtenir un entier aplati en POST ou PUT.
Obligatoire sur :POST
notes string Toutes les notes relatives au mappage carrier-netblock.
Par défaut:null
last_activity date Date et heure de la dernière modification du mappage carrier-netblock.

Exemples

Ajouter un mappage 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"
    },
  }
}

Mettre à jour un mappage 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"
    },
  }
}

Afficher tous les mappages 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"
      }
    ],
  }
}

Afficher un mappage carrier-netblock spécifique

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