Licitadores: servicio de región
Artículo 05/17/2024
2 colaboradores
Comentarios
En este artículo
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 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/regionVer todas las regiones.
GET
https://api.adnxs.com/region?id=IDVer una región específica.
GET
https://api.adnxs.com/region?name=NAMEVer una región específica.
GET
https://api.adnxs.com/region?code=CODEVer una región específica.
GET
https://api.adnxs.com/region/metaAverigüe por qué campos puede filtrar y ordenar.
Campos JSON
Campo
Tipo
Description
codeenumeración
Código ISO o FIPS para la región.
country_codeenumeración
Código ISO del país al que pertenece la región. Puede usar country service para recuperar una lista completa de códigos de país.
country_idEntero
Identificador del país al que pertenece la región.
country_namestring
Nombre del país al que pertenece la región. Puede usar country service para recuperar una lista completa de nombres de país.
idEntero
Identificador de la región.
namestring
Nombre de la región.
Ejemplos
Ver todas las regiones de Alemania
$ curl -b cookies -c cookies 'https://api.adnxs.com/region?country_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"
}
]
}
}