Controla el uso de tu clave antes de alcanzar un límite
Vigilar las cabeceras de cuota sobre la marcha te indica cuándo te acercas a un límite, mucho antes de que se rechace realmente una solicitud.
Prueba tu integración sin gastar tu cuota diaria
Crear una integración suele implicar decenas o cientos de llamadas de prueba antes de que nada se acerque al tráfico de producción, y ninguna de esas pruebas necesita pasar por un nivel de pago.
Pruebas sin ninguna clave
Hay 2.500 solicitudes gratuitas al día disponibles desde cualquier dirección sin necesidad de clave, lo que basta para la mayor parte del trabajo de integración: preparar el formato de las solicitudes, comprobar el análisis de las respuestas y repasar la gestión de errores con unos pocos casos de prueba cada uno.
GET /v1/forward?q=Test Address, Test City&limit=1Sin cabecera X-API-Key, sin cabecera Authorization, nada más que la propia solicitud.
Vigilar las cabeceras de cuota durante las pruebas
Incluso sin clave, cada respuesta lleva las mismas cabeceras de cuota, así que puedes ver cómo X-Quota-Used y X-Quota-Free-Remaining suben y bajan exactamente como lo harían en producción, lo que resulta útil para probar cómo gestiona tu propio código esas cabeceras antes de que importe de verdad.
X-Quota-Limit: 2500
X-Quota-Used: 42
X-Quota-Free-Remaining: 2458Probar una clave sin gastar crédito
Cuando te registras y generas una clave, esa clave también recibe sus propias 2.500 solicitudes gratuitas al día, un espacio de pruebas independiente que no toca el crédito prepago ni cuenta contra un paquete Unlimited. Este es el momento de probar el comportamiento específico de la clave, como las distintas formas de enviarla (encabezado, token bearer, autenticación básica o parámetro de consulta), todo sin gastar nada.
Probar a propósito las rutas de error
Envía una solicitud con un parámetro no válido para ver un 400, o una clave intencionadamente incorrecta para ver un 401, de modo que tu código de manejo de errores se haya ejercitado de verdad antes del lanzamiento en lugar de dar por hecho que funciona. Cada una de estas llamadas de prueba, tenga éxito o no, es una solicitud contra la cuota gratuita, algo que no debería preocuparte con volúmenes normales de pruebas.
Pasar al tráfico de producción
Cuando empieza el tráfico real, la misma cuota gratuita sigue cubriendo el uso diario típico de muchas integraciones pequeñas, y el crédito prepago o un paquete Unlimited solo hacen falta cuando el volumen supera las 2.500 solicitudes al día.
Aquí no hace falta un entorno sandbox aparte, ya que la cuota gratuita ya ofrece un terreno de pruebas completo con la API real. Empieza generando una clave desde el panel, o lee primero la documentación de autenticación si quieres ver los formatos de clave antes de registrarte.