API de Códigos Postales

<?php
$API_KEY = 'test_key_123456';
$BASE_URL = 'https://cpostal.mx/api/v1';

function callAPI($endpoint, $apiKey) {
    $ch = curl_init();

    curl_setopt_array($ch, [
        CURLOPT_URL => $endpoint,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'X-API-Key: ' . $apiKey
        ]
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    return json_decode($response, true);
}

// Buscar por código postal
function buscarCodigoPostal($cp) {
    global $BASE_URL, $API_KEY;

    $data = callAPI("$BASE_URL/codigo-postal/$cp", $API_KEY);

    if ($data['success']) {
        echo "Estado: " . $data['data']['estado'] . "\n";
        echo "Municipio: " . $data['data']['municipio'] . "\n";
        foreach ($data['data']['colonias'] as $col) {
            echo "- " . $col['colonia'] . " (" . $col['tipo_asentamiento'] . ")\n";
        }
    } else {
        echo "Error: " . $data['error']['message'] . "\n";
    }

    return $data;
}

// Buscar colonias
function buscarColonias($texto) {
    global $BASE_URL, $API_KEY;
    return callAPI("$BASE_URL/buscar?q=" . urlencode($texto), $API_KEY);
}

// Ejemplo de uso
buscarCodigoPostal('06600');
$resultados = buscarColonias('polanco');
print_r($resultados);

import requests

API_KEY = 'test_key_123456'
BASE_URL = 'https://cpostal.mx/api/v1'

headers = {
    'X-API-Key': API_KEY
}

def buscar_codigo_postal(cp):
    """Busca información de un código postal"""
    response = requests.get(f'{BASE_URL}/codigo-postal/{cp}', headers=headers)
    data = response.json()

    if data['success']:
        print(f"Estado: {data['data']['estado']}")
        print(f"Municipio: {data['data']['municipio']}")
        for col in data['data']['colonias']:
            print(f"- {col['colonia']} ({col['tipo_asentamiento']})")
    else:
        print(f"Error: {data['error']['message']}")

    return data

def buscar_colonias(texto):
    """Busca colonias por nombre"""
    response = requests.get(f'{BASE_URL}/buscar', headers=headers, params={'q': texto})
    return response.json()

def obtener_estados():
    """Obtiene lista de estados"""
    response = requests.get(f'{BASE_URL}/estados', headers=headers)
    return response.json()

def obtener_municipios(estado_id):
    """Obtiene municipios de un estado"""
    response = requests.get(f'{BASE_URL}/estados/{estado_id}/municipios', headers=headers)
    return response.json()

# Ejemplo de uso
if __name__ == '__main__':
    buscar_codigo_postal('06600')

    resultados = buscar_colonias('polanco')
    print(f"\nResultados para 'polanco': {resultados['data']['total']}")

    estados = obtener_estados()
    print(f"\nTotal estados: {estados['data']['total']}")

using System;
using System.Net.Http;
using System.Text.Json;
using System.Threading.Tasks;

public class CPostalAPI
{
    private const string API_KEY = "test_key_123456";
    private const string BASE_URL = "https://cpostal.mx/api/v1";
    private readonly HttpClient _client;

    public CPostalAPI()
    {
        _client = new HttpClient();
        _client.DefaultRequestHeaders.Add("X-API-Key", API_KEY);
    }

    public async Task<JsonDocument> BuscarCodigoPostalAsync(string cp)
    {
        var response = await _client.GetAsync($"{BASE_URL}/codigo-postal/{cp}");
        var json = await response.Content.ReadAsStringAsync();
        return JsonDocument.Parse(json);
    }

    public async Task<JsonDocument> BuscarColoniasAsync(string texto)
    {
        var response = await _client.GetAsync($"{BASE_URL}/buscar?q={Uri.EscapeDataString(texto)}");
        var json = await response.Content.ReadAsStringAsync();
        return JsonDocument.Parse(json);
    }

    public async Task<JsonDocument> ObtenerEstadosAsync()
    {
        var response = await _client.GetAsync($"{BASE_URL}/estados");
        var json = await response.Content.ReadAsStringAsync();
        return JsonDocument.Parse(json);
    }

    public async Task<JsonDocument> ObtenerMunicipiosAsync(int estadoId)
    {
        var response = await _client.GetAsync($"{BASE_URL}/estados/{estadoId}/municipios");
        var json = await response.Content.ReadAsStringAsync();
        return JsonDocument.Parse(json);
    }
}

// Ejemplo de uso
class Program
{
    static async Task Main(string[] args)
    {
        var api = new CPostalAPI();

        var resultado = await api.BuscarCodigoPostalAsync("06600");
        Console.WriteLine(resultado.RootElement.ToString());

        var estados = await api.ObtenerEstadosAsync();
        Console.WriteLine($"Total estados: {estados.RootElement.GetProperty("data").GetProperty("total")}");
    }
}

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class CPostalAPI {
    private static final String API_KEY = "test_key_123456";
    private static final String BASE_URL = "https://cpostal.mx/api/v1";
    private final HttpClient client;

    public CPostalAPI() {
        this.client = HttpClient.newHttpClient();
    }

    public String buscarCodigoPostal(String cp) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "/codigo-postal/" + cp))
            .header("X-API-Key", API_KEY)
            .GET()
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        return response.body();
    }

    public String buscarColonias(String texto) throws Exception {
        String encoded = URLEncoder.encode(texto, StandardCharsets.UTF_8);

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "/buscar?q=" + encoded))
            .header("X-API-Key", API_KEY)
            .GET()
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        return response.body();
    }

    public String obtenerEstados() throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + "/estados"))
            .header("X-API-Key", API_KEY)
            .GET()
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        return response.body();
    }

    public static void main(String[] args) throws Exception {
        CPostalAPI api = new CPostalAPI();

        String resultado = api.buscarCodigoPostal("06600");
        System.out.println(resultado);

        String colonias = api.buscarColonias("polanco");
        System.out.println(colonias);
    }
}

# Información de la API
curl -H "X-API-Key: test_key_123456" https://cpostal.mx/api/v1/

# Buscar por código postal
curl -H "X-API-Key: test_key_123456" https://cpostal.mx/api/v1/codigo-postal/06600

# Buscar colonias por nombre
curl -H "X-API-Key: test_key_123456" "https://cpostal.mx/api/v1/buscar?q=polanco"

# Listar estados
curl -H "X-API-Key: test_key_123456" https://cpostal.mx/api/v1/estados

# Listar municipios de un estado (CDMX = 9)
curl -H "X-API-Key: test_key_123456" https://cpostal.mx/api/v1/estados/9/municipios

# Ver headers de rate limit
curl -i -H "X-API-Key: test_key_123456" https://cpostal.mx/api/v1/estados

# Usando API key como parámetro (alternativa)
curl "https://cpostal.mx/api/v1/estados?api_key=test_key_123456"