API REST de códigos postales de México. Consulta colonias, municipio, estado y ciudad a partir de un código postal, o encuentra el código postal a partir del nombre de una colonia. Ideal para validar direcciones, autocompletar formularios de envío o facturación, y evitar errores de captura en checko
Todas las peticiones van al gateway de idoo.dev con tu API key:
API de consulta de códigos postales de México (catálogo de asentamientos, municipios y estados). Publicada en el marketplace de idoo.dev: toda la autenticación, planes, cuotas y límites de uso los gestiona el gateway — solo necesitas tu API key de idoo.dev, no hay ningún token adicional que manejar.
Usa tu API key de idoo.dev contra la URL del gateway:
Authorization: Bearer {tu_api_key}
GET https://api.idoo.dev/v1/{slug-de-esta-api}/...
Todos son GET y aceptan los parámetros como query string.
GET /index?codigo=CODIGO_POSTAL
curl "https://api.idoo.dev/v1/codigos-postales-mx/index?codigo=44250" \
-H "Authorization: Bearer {tu_api_key}"
GET /index?colonia=ASENTAMIENTO&municipio=MUNICIPIO
curl "https://api.idoo.dev/v1/codigos-postales-mx/index?colonia=Huentitan&municipio=Guadalajara" \
-H "Authorization: Bearer {tu_api_key}"
GET /index?colonia=ASENTAMIENTO
curl "https://api.idoo.dev/v1/codigos-postales-mx/index?colonia=Huentitan" \
-H "Authorization: Bearer {tu_api_key}"
{
"valid": true,
"status": 200,
"html": "",
"data": [
{
"Codigo": "44250",
"Asentamiento": "Huentitán El Bajo",
"TipoAsentamiento": "Colonia",
"Municipio": "Guadalajara",
"Estado": "Jalisco",
"Ciudad": "Guadalajara"
}
]
}
| Status | Cuándo ocurre | Contenido de data |
|---|---|---|
| 400 | Falta el parámetro codigo, o falta colonia |
Mensaje indicando los parámetros válidos |
| 404 | La búsqueda no encontró ningún resultado | Mensaje de "no se encontraron resultados" |
| 405 | Se usó un método distinto de GET |
Mensaje de método no permitido |
| 401 | Firma del gateway inválida o ausente (no debería ocurrir consumiendo vía idoo.dev; solo si alguien intenta llamar al backend directo) | Mensaje de no autorizado |
Esta API todavía no tiene reseñas.