Conectar los códigos postales de México a tu stack
Cuatro páginas, una por stack, cada una con una integración completa en lugar de un fragmento suelto: el cliente, dónde vive la llave, qué guardar en caché y cuáles de las fallas te tocan a ti.
La parte que es igual en todas partes
No hay SDK que instalar ni nada que configurar. Es HTTPS, un token Bearer en un encabezado y JSON de regreso. Si entiendes esta llamada, ya entiendes las cuatro páginas de abajo.
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
https://api.postalkit.mx/v1/postal-codes/06600
El encabezado Accept no es decoración. Pide sin él una ruta que no existe y recibes una página de error en HTML en lugar de JSON, y lo primero que se rompe es tu parser, no tu manejo de errores.
Elige aquel en el que estás trabajando
-
Laravel Laravel 13.25 · PHP 8.5
Una clase de servicio sobre el cliente HTTP, un caché que sobrevive a un código que no existe y una regla de validación que rechaza un código postal malo antes de que se guarde el formulario.
-
Node.js Node 22.23 · Express 5.2
Un cliente en cuarenta líneas de fetch nativo, un tipo de error que vale la pena atrapar y la ruta que mantiene tu API key en el servidor, que es donde va.
-
Python Python 3.14 · requests 2.34
Una sesión con pool y reintentos, los dos 429 distintos y cómo distinguirlos, y enriquecer una hoja de direcciones sin gastarte el mes en ella.
-
React React 19.2
El formulario de dirección que llena estado y municipio y ofrece la colonia como lista: con debounce, cancelable y sin ninguna API key en el bundle.
Lee el de la capa que estás escribiendo. La página de React es la excepción: da por hecho que tienes un backend y te dice que pongas una petición detrás de él, así que se lee mejor después de la página de servidor que te toque.
Por qué están ahí los números de versión
Cada fragmento de estas páginas se ejecutó antes de publicarse
Cada ejemplo se ejecutó contra esta API, cambiando la ruta autenticada por la consulta demo sin llave en el mismo host, de modo que el cliente, las ramas de error y el parseo son código que corrió y no código que parece que correría. Las versiones junto a cada tutorial son aquellas sobre las que corrió, no una promesa de compatibilidad, que es algo que aquí nadie ha probado.
Última ejecución: 2026-08-17.