Enumerar los países y estados compatibles

Devuelve el catálogo completo de países y sus subdivisiones (estados, provincias, territorios) que Listings API admite para los datos de ubicación. Cada entrada de país contiene su código ISO (iso), un id de Relay, un databaseId numérico, un array states y tres indicadores que especifican cómo se valida la dirección de una ubicación en ese país. Cada estado contiene su propio iso y un id numérico. Los países que Listings API no subdivide devuelven un array states vacío.

Reglas de dirección por país

postalCode es opcional en todos los países, pero envíalo siempre que hasPostalCode sea true: algunas plataformas de publicación lo necesitan para situar el marcador en el mapa. Si envías un valor, se valida según el formato del país (SY10014). Con hideAddress: true en la ubicación, se omiten las validaciones de ciudad y estado.

Caso de uso: rellenar los desplegables de dirección. Obtén estos datos una vez al iniciar la aplicación y guárdalos en caché. Genera el selector de país a partir de name/iso y, cuando se elija un país, rellena el selector de estado con los datos de states de ese país. Los valores de iso se utilizan directamente en los campos countryIso y stateIso de los endpoints create-location y update-location.

Caso de uso: validar una dirección antes de enviarla. Antes de llamar a create-location, comprueba que el valor de countryIso que vas a usar exista en esta lista, que stateIso aparezca bajo ese país cuando stateRequired sea true y que city tenga un valor cuando hasCity sea true. Detectar aquí un código no admitido permite mostrar un mensaje claro en el cliente en lugar de recibir un 400 de la llamada de creación. La respuesta completa es grande (incluye todos los países admitidos); el ejemplo anterior se ha reducido a una sola entrada. No hay parámetros de consulta; el endpoint siempre devuelve el conjunto completo.