La mayoría de las API te obligan a adivinar cómo vas de uso hasta que algo falla. My Geocode lo enfoca de otra manera: cada respuesta, en todos los endpoints y todos los hosts de compatibilidad, incluye un conjunto completo de cabeceras de cuota que te dicen exactamente en qué punto estás.
X-Quota-Limit y X-Quota-Used dan la imagen básica para la clave o la red que hace la llamada. X-Quota-Free-Remaining muestra cuánto queda de la cuota diaria gratuita, y X-Quota-Network-Used refleja cuánto de esa cuota gratuita compartida por red han consumido ya las direcciones o claves de la misma conexión. X-Credits-Remaining muestra el saldo de crédito prepago para quien ha superado el nivel gratuito y no tiene un paquete Unlimited. X-Key-IPs-Used y X-Key-IPs-Limit registran desde cuántas direcciones distintas se ha usado una clave, y X-Quota-Reset te indica cuándo se reinician los contadores diarios.
El motivo por el que esto importa es sencillo: un script que puede ver su propia cuota puede comportarse de forma inteligente en función de ella. Puede ir más despacio antes de que lo bloqueen, avisar a un desarrollador cuando el crédito se está agotando o pasar automáticamente de una clave gratuita a una de pago en lugar de fallar primero y reaccionar después. Nada de eso requiere llamar a un endpoint de uso aparte ni revisar un panel a mano. La información viaja junto con la respuesta que ya habías pedido.
Esto es así tanto si usas nuestros endpoints nativos como uno de los diecisiete hosts de compatibilidad. Una solicitud con el formato de una llamada a Google Maps Platform, Bing Maps REST Services o ipstack vuelve igualmente con nuestras cabeceras de cuota, además del cuerpo de respuesta que corresponda al formato de ese proveedor. Cambiar de proveedor no significa perder esta visibilidad, sino ganarla en sitios donde nunca la hubo.
Cada clave tiene una cuota diaria gratuita. Una vez superada, las solicitudes consumen crédito prepago o quedan cubiertas por un paquete Unlimited. Cada respuesta te indica en sus cabeceras en qué punto estás, algo pequeño en una sola llamada y realmente útil a lo largo de un día de mucho tráfico.
Para los equipos que crean algo más que un script puntual, te sugerimos registrar estas cabeceras junto con tus propios registros de solicitudes desde el principio. Una tendencia silenciosa de X-Quota-Free-Remaining bajando más rápido de lo esperado es mucho más barata de detectar en un gráfico que en un ticket de soporte. Todos los detalles de cada cabecera y de lo que la activa están documentados en /docs/rate-limits/, junto con la guía general de autenticación en /docs/authentication/.