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 o regiones 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 o regiones.
GET	https://api.appnexus.com/country?id=ID	Vea un país o región específico por identificador.
GET	https://api.appnexus.com/country?name=NAME	Vea un país o región específico por NAME.
GET	https://api.appnexus.com/country?code=CODE	Vea un país o región específico por CODE.
GET	https://api.appnexus.com/country/meta	Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

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

Ejemplos

Ver todos los países o regiones

$ 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 o región 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 o región 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 o regiones 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
            }
        ]
    }
}