Compartir a través de


API de plataforma digital: servicio de país

El Servicio de país de solo lectura le permite ver información sobre los países registrados en el sistema Xandr. Puede usar este servicio para recuperar el identificador de destino en las campañas (consulte country_targets el servicio de perfil).

API de REST

Http (método) Endpoint Description
GET https://api.appnexus.com/country Ver todos los países.
GET https://api.appnexus.com/country?id=ID Ver un país específico por identificador.
GET https://api.appnexus.com/country?name=NAME Vea un país específico por NAME.
GET https://api.appnexus.com/country?code=CODE Vea un país específico por CODE.
GET https://api.appnexus.com/country/meta Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

Campo Tipo Description
id Entero El identificador del país.
name string Nombre del país.
code string Código ISO para el país.
active Booleano Si es true, el país está disponible para la selección de destino. Si es false, no hay datos de geolocalización para el país, por lo que no es posible la entrega.

Ejemplos

Ver todos los países

$ curl -b cookies -c cookies 'https://api.appnexus.com/country'
{
    "response": {
        "status": "OK",
        "count": 250,
        "start_element": null,
        "num_elements": null,
        "countries": [
            {
                "id": 1,
                "name": "Anonymous Proxy",
                "code": "A1",
                "active": true
            },
            {
                "id": 2,
                "name": "Satellite Provider",
                "code": "A2",
                "active": true
            },
            {
                "id": 3,
                "name": "Other Country",
                "code": "O1",
                "active": true
            },
            ...
        ]
    }
}

Visualización de un país específico por identificador

$ curl -b cookies -c cookies 'https://api.appnexus.com/country?id=59'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "country": {
            "id": 59,
            "name": "Germany",
            "code": "DE",
            "active": true
        }
    }
}

Visualización de un país específico por código

$ curl -b cookies -c cookies 'https://api.appnexus.com/country?code=DE'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "countries": [
            {
                "id": 59,
                "name": "Germany",
                "code": "DE",
                "active": true
            }
        ]
    }
}

Ver todos los países que contienen "United" en sus nombres

$ curl -b cookies -c cookies 'https://api.appnexus.com/country?like_name=United'
{
    "response": {
        "status": "OK",
        "count": 5,
        "start_element": null,
        "num_elements": null,
        "countries": [
            {
                "id": 5,
                "name": "United Arab Emirates",
                "code": "AE",
                "active": true
            },
            {
                "id": 80,
                "name": "United Kingdom",
                "code": "GB",
                "active": true
            },
            {
                "id": 229,
                "name": "Tanzania, United Republic of",
                "code": "TZ",
                "active": true
            },
            {
                "id": 232,
                "name": "United States Minor Outlying Islands",
                "code": "UM",
                "active": true
            },
            {
                "id": 233,
                "name": "United States",
                "code": "US",
                "active": true
            }
        ]
    }
}