Entiende cómo funciona COPOMEX — código postal mexicano, créditos, modo pruebas y el parámetro simplified.
El Código Postal Mexicano es un número de 5 dígitos administrado por el Servicio Postal Mexicano (SEPOMEX). Cada código postal corresponde a uno o más asentamientos (colonias, fraccionamientos, pueblos, etc.) dentro de un municipio y estado.
06600
│└──── Zona dentro del estado (3 dígitos)
└───── Entidad federativa (2 dígitos: 09 = Ciudad de México)
| Tipo | Descripción |
|---|---|
Colonia | Área urbana subdivida con nombre propio |
Fraccionamiento | Desarrollo habitacional planificado |
Pueblo | Localidad rural o semiurbana |
Zona industrial | Área destinada a actividad industrial |
Ranchería | Agrupación de viviendas rurales pequeñas |
Unidad habitacional | Conjunto de viviendas bajo un mismo nombre |
type=simplifiedEl endpoint info_cp acepta el parámetro opcional type=simplified. Afecta el formato de la respuesta:
| Modo | asentamiento | response |
|---|---|---|
Sin simplified | Objeto completo por colonia | Array de objetos (uno por colonia) |
Con type=simplified | Array de nombres | Objeto único con el CP |
Usa simplified cuando solo necesitas los nombres de las colonias y los datos básicos del CP. Usa el modo completo cuando necesitas los campos SEPOMEX detallados de cada colonia.
Un token es la llave que identifica tu proyecto y autoriza las consultas.
pruebas
Úsalo durante el desarrollo. Devuelve datos con estructura real pero valores aleatorios, sin consumir créditos de tu cuenta. Excepción: el geocoding inverso devuelve datos de prueba fijos.
Lo obtienes desde el panel de control al crear un proyecto. Cada proyecto tiene su propio token independiente.
?token=tu_token_aqui
Se pasa como parámetro GET en cada petición.
Cada consulta exitosa consume 1 crédito de tu plan. Las consultas que devuelven error no consumen crédito.
Excepción: el endpoint
/info_cp_geocoding_reverseconsume 2 créditos por petición.
Con el token pruebas nunca se consumen créditos.
| Código | Causa |
|---|---|
1 | IP o token bloqueado por incumplimiento de términos |
3 | Token de proyecto inválido |
4 | Consultas agotadas en el plan actual |
5 | Proyecto o cuenta suspendida |