Insignia de IP

IP Badge es una “API de imágenes” ligera que toma la IP del visitante (o una IP que especifiques) junto con el country_code (código de país) y el country_name (nombre del país, opcional), los renderiza como una insignia SVG incrustable y la devuelve con Content-Type: image/svg+xml. A diferencia de las API tradicionales que devuelven JSON, una insignia SVG puede mostrarse como una imagen normal en README, paneles de administración, pantallas de monitorización, páginas de estado o en cualquier lugar que soporte <img>, sin necesidad de renderizado adicional en el front-end.

La herramienta utiliza un diseño de insignia de dos segmentos (similar a shields.io): a la izquierda suele aparecer la IP y a la derecha el resultado (código de país o “código + nombre del país”). También permite controlar colores e idiomas mediante segmentos de ruta. En cuanto a fuentes de datos, la geolocalización por IP usa la tabla local ip2location_db11 (comparación por rangos IPv4 para obtener country_code), y los nombres de país multilingües provienen de sys_lang_multi, mapeando por vc_code a campos como name_en / name_zh / name_ja ... (el nombre del país solo se muestra cuando la ruta incluye un segmento de idioma). Además, la herramienta intenta obtener la IP real del cliente a partir de cabeceras de proxy comunes (por ejemplo, Cloudflare, X-Forwarded-For), lo que la hace adecuada para despliegues detrás de CDN, reverse proxy o balanceadores de carga.

La forma de uso principal de IP Badge es: usar la ruta como URL de imagen. Si abres la ruta en el navegador verás la insignia SVG, y si enlazas la misma URL en Markdown o HTML se renderiza como imagen. Para cubrir diferentes necesidades de “densidad de información”, las rutas se dividen en dos grandes grupos: myip y check: myip es para mostrar (solo IP) y check es para consultar (con información del país). Además, el nombre del país solo se muestra cuando la ruta incluye -<lang>; sin idioma, solo se muestra el código para mantener la insignia más corta y con aspecto de “badge de estado”.

GET /myip

GET /check-ip

GET /check-8.8.8.8

GET /check-ip-zh

GET /check-8.8.8.8-zh

IP Badge permite añadir -<color> al final de la ruta para controlar el color de fondo (normalmente el área de resultado a la derecha), con una experiencia similar a shields.io: puedes usar tokens sencillos (como blue/green/red/gray) o un valor hex de 6 dígitos (sin #). Así puedes asociar colores a un significado de negocio, por ejemplo “green = normal, yellow = atención, red = alto riesgo”, para que la insignia transmita información y semántica de estado.

Como IP Badge devuelve una imagen SVG, la recomendación principal es incrustarla directamente. En README o Wiki de GitHub/GitLab, basta con la sintaxis de imagen en Markdown; en cualquier web o panel de administración, usa la etiqueta <img>. La mayor ventaja es que no necesitas lógica adicional en el front-end ni manejar CORS con JSON, plantillas o tipografías: el navegador puede renderizar SVG como imagen de forma nativa.

![IP Badge](https://s.ipin.io/check-ip-zh-blue)

<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="IP Badge" />

IP Badge es muy adecuado para necesidades de “visualización”. Por ejemplo, en una página de estado de operaciones puedes convertir la IP/país de salida de distintos nodos en una “pared de insignias” para detectar de un vistazo si algún nodo está saliendo desde una región inesperada; en operaciones de seguridad puedes incrustar IPs de alerta como insignias rojas en tickets o notificaciones (por ejemplo, “US United States” / “RU Russia”), de forma que el personal de guardia entienda el contexto de riesgo sin abrir detalles; al depurar cadenas de CDN/reverse proxy, acceder a /myip y /check-ip ayuda a verificar rápidamente si la IP real se está reenviando correctamente o se está sobrescribiendo; en backoffices multilingües o SaaS internacional, usar -zh/-en/-ja permite que la misma IP muestre distintos nombres de país según el idioma, reduciendo el coste de mantener diccionarios de localización en el front-end. Además, puedes vincular color y estado de negocio, por ejemplo verde = “permitido”, amarillo = “requiere verificación”, rojo = “bloqueado/alto riesgo”, para que la insignia cumpla doble función: “info + estado”.

Nota: si vas a exponerlo a internet, se recomienda aplicar una política de “cabeceras de proxy de confianza” en el reverse proxy o en la capa de aplicación, para evitar que el cliente falsifique cabeceras como X-Forwarded-For y provoque resultados incorrectos. También se recomienda crear índices en ip2location_db11.ip_from y sys_lang_multi.vc_code, y usar cabeceras de caché para mejorar el rendimiento y la estabilidad.