Quickstart · Guía rápida

Empieza a usar Koordex en menos de 5 minutos

Sigue estos pasos para obtener tu API Key, hacer tu primera petición y leer la respuesta JSON. Ideal para integrar Koordex en e-commerce, sistemas de logística o CRM.

1 Crea tu cuenta y obtén tu API Key

Regístrate en el panel de Koordex y copia tu API Key desde la sección “Tu API Key”. Con esta llave podrás autenticar todas tus peticiones.

Entra al panel: Panel Koordex
Regístrate o inicia sesión
Copia tu API Key

Tip: guarda tu API Key como variable de entorno (por ejemplo KOORDEX_API_KEY) y no la subas a repositorios públicos.

2 Haz tu primera petición (curl)

Usa curl para probar rápidamente el endpoint principal de Koordex:

curl -X POST "https://koordex.software/api/index.php" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TU_API_KEY" \
  -d '{
    "address": "Providencia 1540, Tlacoquemécatl, Benito Juárez, Ciudad de México",
    "country": "MX"
  }'

Si todo está correcto, obtendrás una respuesta con la dirección normalizada y las coordenadas geográficas.

3 Integra en tu backend (ejemplo PHP)

A continuación un ejemplo sencillo en PHP usando cURL:

<?php
$apiKey = 'TU_API_KEY';
$url    = 'https://koordex.software/api/index.php';

$data = [
  'address' => 'Providencia 1540, Tlacoquemécatl, Benito Juárez, Ciudad de México',
  'country' => 'MX'
];

$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
  ],
  CURLOPT_POSTFIELDS     => json_encode($data),
]);

$response = curl_exec($ch);
if ($response === false) {
  throw new \RuntimeException('Error en cURL: ' . curl_error($ch));
}
curl_close($ch);

$result = json_decode($response, true);

if (!empty($result['success'])) {
  $lat = $result['location']['lat'] ?? null;
  $lng = $result['location']['lng'] ?? null;
  echo "Lat: {$lat} - Lng: {$lng}";
} else {
  var_dump($result);
}

Integra este código en tu servicio de backend y reemplaza TU_API_KEY por tu llave real.

4 Buenas prácticas: caché, errores y límites

Para producción, considera estas recomendaciones:

Implementa caché a nivel de base de datos o memoria para direcciones repetidas.
Maneja códigos de error HTTP (400, 401, 422, 429, 500).
Configura timeouts razonables en tus peticiones (por ejemplo 3–5 segundos).
Monitorea tu consumo mensual según el plan (BÁSICO, PRO, PREMIUM).

Consulta la documentación completa para ver ejemplos más avanzados, estructura detallada de la respuesta y manejo de errores.