Irakurri ingelesez

Partekatu honen bidez:

Licitadores: servicio de región

  • Artikulua

El servicio de región de solo lectura permite ver información sobre las regiones y los estados registrados en el sistema Xandr, incluido el país o región al que pertenece cada región o estado. Puede usar este servicio para recuperar identificadores de región para la segmentación en perfiles.

API de REST

Http (método) Endpoint Description
GET https://api.adnxs.com/region Ver todas las regiones.
GET https://api.adnxs.com/region?id=ID Ver una región específica.
GET https://api.adnxs.com/region?name=NAME Ver una región específica.
GET https://api.adnxs.com/region?code=CODE Ver una región específica.
GET https://api.adnxs.com/region/meta Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

Campo Tipo Descripción
code enumeración Código ISO o FIPS para la región.
country_code enumeración El código ISO del país o región al que pertenece la región. Puede usar country service para recuperar una lista completa de códigos de país.
country_id Entero Identificador del país o región al que pertenece la región.
country_name string Nombre del país o región al que pertenece la región. Puede usar country service para recuperar una lista completa de nombres de país.
id Entero Identificador de la región.
name string Nombre de la región.

Ejemplos

Ver todas las regiones de Alemania

$ curl -b cookies -c cookies 'https://api.adnxs.com/region?country or region_code=DE'
{
    "response": {
        "status": "OK",
        "count": 16,
        "start_element": null,
        "num_elements": null,
        "regions": [
            {
                "id": 825,
                "name": "Baden-Wurttemberg",
                "code": "01",                
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 826,
                "name": "Bayern",
                "code": "02",                
                "country_id": 69,                
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 827,
                "name": "Bremen",
                "code": "03",
                "country_id": 69,                                
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 828,
                "name": "Hamburg",
                "code": "04",
                "country_id": 69,                                
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 829,
                "name": "Hessen",
                "code": "05",
                "country_id": 69,                                                
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 830,
                "name": "Niedersachsen",
                "code": "06",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 831,
                "name": "Nordrhein-Westfalen",
                "code": "07",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 832,
                "name": "Rheinland-Pfalz",
                "code": "08",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 833,
                "name": "Saarland",
                "code": "09",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 834,
                "name": "Schleswig-Holstein",
                "code": "10",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 835,
                "name": "Brandenburg",
                "code": "11",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 836,
                "name": "Mecklenburg-Vorpommern",
                "code": "12",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 837,
                "name": "Sachsen",
                "code": "13",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 838,
                "name": "Sachsen-Anhalt",
                "code": "14",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 839,
                "name": "Thuringen",
                "code": "15",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 840,
                "name": "Berlin",
                "code": "16",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            }
        ],
        "dbg_info": {
            ...
        }
    }
}

Ver todas las regiones de Alemania y Francia

$ curl -b cookies -c cookies 'https://api.adnxs.com/region?country_code=DE,FR'
{
    "response": {
        "status": "OK",
        "count": 38,
        "start_element": null,
        "num_elements": null,
        "regions": [
            {
                "id": 825,
                "name": "Baden-Wurttemberg",
                "code": "01",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 826,
                "name": "Bayern",
                "code": "02",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 827,
                "name": "Bremen",
                "code": "03",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            {
                "id": 828,
                "name": "Hamburg",
                "code": "04",
                "country_id": 69,
                "country_code": "DE",
                "country_name": "Germany"
            },
            ...
            {
                "id": 1070,
                "name": "Aquitaine",
                "code": "97",
                "country_id": 78,
                "country_code": "FR",
                "country_name": "France"
            },
            {
                "id": 1071,
                "name": "Auvergne",
                "code": "97",
                "country_id": 78,
                "country_code": "FR",
                "country_name": "France"
            },
            {
                "id": 1072,
                "name": "Basse-Normandie",
                "code": "99",
                "country_id": 78,
                "country_code": "FR",
                "country_name": "France"
            },
            ...
        ],
        "dbg_info": {
            ...
        }
    }
}

Ver todas las regiones que contienen "California" en sus nombres

$ curl -b cookies -c cookies 'https://api.adnxs.com/region?like_name=California'
{
    "response": {
        "status": "OK",
        "count": 3,
        "start_element": null,
        "num_elements": null,
        "regions": [
            {
                "id": 2600,
                "name": "Baja California",
                "code": "02",
                "country_id": 42,
                "country_code": "MX",
                "country_name": "Mexico"
            },
            {
                "id": 2601,
                "name": "Baja California Sur",
                "code": "03",
                "country_id": 42,
                "country_code": "MX",
                "country_name": "Mexico"
            },
            {
                "id": 3922,
                "name": "California",
                "code": "CA",
                "country_id": 233,
                "country_code": "US",
                "country_name": "United States"
            }
        ]
    }
}