--- title: "Conexiones" description: "Conexiones" type: "faq" category: "question" tags: [] authors: [Anonymous] date: "2026-09-11" last_update: "2026-09-11" time_minutes: 1 draft: false unlisted: false url: "https://www.apigateway.cl/faq/conexiones" --- # Conexiones --- ## ¿Qué es una conexión? La conexión es la unidad de trabajo del servicio: agrupa token, créditos, productos, proxy y facturación. # ¿Qué es una conexión? Es la **unidad de trabajo** de API Gateway. Dentro de una conexión viven el token con que autenticas tus consultas, su saldo de créditos, los productos activos, el proxy y los datos de facturación. Lo más importante: **los créditos son de la conexión, no de la cuenta**. Si tienes dos conexiones, cada una tiene su propio saldo y sus propios productos. Puedes ver tus conexiones en [Mis conexiones](https://app.apigateway.cl/dashboard) y administrar la seleccionada en [Gestionar conexión](https://app.apigateway.cl/connections/manage). El detalle de cada sección está en el [manual de conexiones](https://www.apigateway.cl/docs/manual/conexiones). --- ## ¿Cómo registro una conexión? Pasos para registrar una conexión nueva y dejarla operativa. # ¿Cómo registro una conexión? 1. Entra a [Registrar conexión](https://app.apigateway.cl/connections/register) y completa el nombre con que la identificarás y los datos de facturación. 2. En [Mis conexiones](https://app.apigateway.cl/dashboard) presiona **"Ingresar"** en la conexión creada. 3. Activa los productos en [Gestionar conexión → Productos](https://app.apigateway.cl/connections/manage#products) y presiona **"Actualizar productos y límites"**. 4. Genera el token en [Gestionar conexión → Token](https://app.apigateway.cl/connections/manage#token). 5. Configura el proxy: es obligatorio para consumir el servicio. Revisa el [tutorial de proxy](https://www.apigateway.cl/docs/tutoriales/proxy). > [!WARNING] Activar productos consume créditos de inmediato > > Se descuenta el costo del producto, proporcional a los días que restan del mes, y los créditos consumidos no se reembolsan. Antes de activar, revisa cuánto cuesta cada uno en el [cotizador](https://www.apigateway.cl/pricing). El paso a paso completo está en el [manual de conexiones](https://www.apigateway.cl/docs/manual/conexiones). --- ## ¿Puedo tener más de una conexión, incluso con el mismo RUT? Sí, y se pueden facturar al mismo RUT; cada una mantiene su propio saldo de créditos. # ¿Puedo tener más de una conexión, incluso con el mismo RUT? **Sí.** Puedes tener varias conexiones y **facturarlas al mismo identificador fiscal**. Lo típico es separar producción de desarrollo, o dos sistemas internos cuyo consumo quieres auditar por separado. Lo que sigue siendo por conexión: - **Los créditos.** Cada conexión tiene su propio saldo y no se traspasan. - **La base mensual.** Dos conexiones con los mismos productos la pagan dos veces. - **El proxy, el token y el nombre**, que debe ser único en tu cuenta. Ten presente que las conexiones que **nunca han pagado un cobro** solo pueden consultar desde una IP que ninguna otra conexión haya usado. Revisa [¿Por qué me dice que no está permitido consultar desde mi IP?](https://www.apigateway.cl/faq/conexiones/no-puedo-consultar-desde-esta-ip). --- ## ¿Por qué mi conexión está suspendida o inactiva si tengo créditos? La conexión se suspende cuando el día 1 del mes el saldo no cubre el cargo fijo mensual completo. # ¿Por qué mi conexión está suspendida o inactiva si tengo créditos? Porque **tener créditos no es lo mismo que tener suficientes**. El día **1 de cada mes** se descuenta el cargo fijo de tu conexión: los productos activos más el pack de usuarios contratado. Si ese día el saldo no cubre ese monto **completo**, la conexión se suspende, aunque tenga saldo disponible. La API responde entonces: ```json { "detail": "La conexión está inactiva." } ``` **Cuánto necesitas:** tu base mensual está en [Gestionar conexión → Productos](https://app.apigateway.cl/connections/manage#products), en *"Base mensual estimada (tu selección)"*. **Cómo reactivarla:** compra créditos en [Gestionar conexión → Créditos](https://app.apigateway.cl/connections/manage#credits). Al procesarse el pago, el sistema descuenta solo el proporcional de los días que quedan del mes y **reactiva la conexión automáticamente**: no hay que pedirlo por soporte. > [!TIP] Para que no se repita > > Mantén saldo suficiente antes del día 1. La cabecera `X-Stats-Credits-Remaining` viene en las respuestas exitosas: úsala para monitorear tu saldo y recargar con anticipación. --- ## ¿Por qué me dice que no está permitido consultar desde mi IP? Las conexiones que nunca han pagado un cobro solo pueden consultar desde una IP que ninguna otra conexión haya usado. # ¿Por qué me dice que no está permitido consultar desde mi IP? ```json { "status": "402", "code": "error", "detail": "No está permitido realizar consultas desde la IP 203.0.113.99, ya que se encuentra en uso por otra conexión. Para consultar desde esta IP debe realizar la compra de créditos." } ``` Tu conexión **todavía no ha pagado ningún cobro**: opera con créditos de bienvenida. Esas conexiones solo pueden consultar desde una IP que **ninguna otra conexión** haya utilizado. **Cómo se resuelve:** compra créditos. Con el pago registrado la restricción se levanta y la conexión queda habilitada para consultar desde cualquier IP, incluidas las compartidas. No se libera por soporte. Mientras tanto, puedes consultar desde una IP que no esté en uso por otra conexión. > [!WARNING] No crees varias cuentas para obtener más créditos de prueba > > Hacerlo provoca el **bloqueo de las cuentas involucradas**, conforme a los [términos y condiciones](https://www.apigateway.cl/legal). --- ## ¿Dónde veo el historial de consumo y de eventos de mi conexión? El dashboard muestra el consumo y el historial de eventos explica los cambios de saldo y configuración. # ¿Dónde veo el historial de consumo y de eventos de mi conexión? Hay dos lugares y responden preguntas distintas. **El [dashboard de la conexión](https://app.apigateway.cl/connections/dashboard)** responde *"¿cuánto estoy consumiendo y en qué?"*: consultas por día y por hora, recursos más consultados, códigos de respuesta, créditos consumidos y los usuarios con que te has autenticado. **El historial de eventos de la conexión** responde *"¿por qué cambió mi saldo o mi configuración?"*: los descuentos mensuales, las activaciones de productos y las suspensiones por créditos insuficientes, cada uno con su fecha y monto. Para llegar al historial, estando dentro de tu conexión, haz clic en el **logo verde** de la parte superior derecha del sitio y entra a **"Historial de eventos de la conexión"**. > [!TIP] Ante una duda de cobro, parte por acá > > La mayoría de las diferencias corresponde al cargo fijo mensual, a la activación de un producto o a un usuario de autenticación adicional, y las tres quedan registradas con su monto. --- ## ¿Puedo cambiar el nombre, el proxy o los datos de facturación de mi conexión? Se editan desde Gestionar conexión, y los de facturación conviene actualizarlos antes del siguiente cobro. # ¿Puedo cambiar el nombre, el proxy o los datos de facturación de mi conexión? Sí, desde [Gestionar conexión](https://app.apigateway.cl/connections/manage): - **Datos**: nombre, descripción y URL del proxy. El nombre debe ser único en tu cuenta. - **Datos de facturación**: identificador fiscal, razón social, giro, dirección, correo, teléfono y referencias. > [!WARNING] Actualiza la facturación antes del siguiente cobro > > El cobro se genera con los datos vigentes al momento de generarse y, una vez generado, **no se puede modificar**. Si necesitas cambiar el RUT a facturar o agregar una orden de compra, hazlo antes. Revisa [¿Cómo agrego una orden de compra?](https://www.apigateway.cl/faq/pagos-y-facturacion/como-agrego-una-orden-de-compra). Después de cambiar el proxy, verifica que se esté usando revisando la cabecera `X-Stats-HttpClientProxy` en la respuesta: si vale `1`, está operando. Revisa [¿Cómo verifico que mi proxy está funcionando?](https://www.apigateway.cl/faq/proxy/como-verifico-que-mi-proxy-funciona). --- Última actualización el 11/09/2026