Ir al contenido
↑↓ moverse↵ abriresc cerrar

Dev Tools

Ayuda de conexión

El panel que aparece cuando la API no responde, qué revisa y los headers CORS que te entrega.

3 min de lectura

Cuando una ejecución contra la API real no recibe respuesta de la API, Luvin muestra un panel llamado No se pudo conectar con la API. Te dice qué revisar, en orden, y te da los headers exactos que debes pedirle a quienes administran la API. No tienes que abrirlo: aparece solo sobre los resultados.

El panel aparece cuando un paso no pudo conectarse: el servidor no respondió, la dirección no existe o el navegador bloqueó la llamada. No aparece cuando la API responde con un error como 401 o 500. Eso son resultados, y los lees en los resultados.

La primera línea dice cuántos casos están afectados y qué servidores no respondieron:

3 caso(s) no obtuvieron respuesta de https://api.shop.test. Suele ser una de estas causas:

Haz clic en la × (Cerrar) para ocultar el panel.

El panel “No se pudo llegar a la API”, con las cabeceras de CORS que hay que pedir y los botones para probar en simulación o revisar el ambiente

El panel es una lista corta. Los ítems que ves dependen de dónde ejecutas Luvin.

Ítem App de escritorio Navegador
¿La URL es correcta y el servidor está encendido? Sí Sí
La página es https y la API es http No Solo si corresponde
¿La API permite llamadas desde esta página (CORS)? No Sí

¿La URL es correcta y el servidor está encendido?

Sección titulada «¿La URL es correcta y el servidor está encendido?»

Abre la dirección en otra pestaña: si no carga, el problema no es Luvin. El panel da un enlace por servidor, Abrir https://api.shop.test ↗. Si la dirección está mal, corrígela en el ambiente (mira más abajo).

Una página abierta por https no puede llamar a una API por http simple. El navegador lo bloquea. Usa la API por https, o abre Luvin por http. La app de escritorio no tiene este límite.

¿La API permite llamadas desde esta página (CORS)?

Sección titulada «¿La API permite llamadas desde esta página (CORS)?»

Un navegador solo deja que una página llame a otra dirección si esa dirección lo permite. Ese permiso se llama CORS. Cuando la API no lo permite, el navegador bloquea la llamada y Luvin no puede ver por qué, así que informa “sin respuesta”.

Si la dirección abre bien en otra pestaña, lo más probable es CORS. El panel muestra los headers con los que debe responder la API, ya completados con la dirección de la página y con tus requests:

Access-Control-Allow-Origin: http://localhost:5173
Access-Control-Allow-Methods: GET, POST, OPTIONS
Access-Control-Allow-Headers: Authorization, Content-Type
Header Qué es De dónde sale el valor
Access-Control-Allow-Origin La dirección que puede llamar a la API. La dirección donde está abierto Luvin.
Access-Control-Allow-Methods Los métodos HTTP permitidos, siempre con OPTIONS. Los métodos de los requests que fallaron.
Access-Control-Allow-Headers Los headers que envían los requests. Los headers de los requests que fallaron, salvo los tres que el navegador envía sin pedir permiso: Accept, Accept-Language y Content-Language. Se omite si no hay ninguno.
  1. Haz clic en Copiar headers. El botón muestra ✓ Copiado.
  2. Envíalos a quienes administran la API y pídeles que respondan con esos headers.
Botón Qué hace
Probar en simulación Ejecuta de nuevo este workflow en Simulación, sin red. Sirve para seguir trabajando mientras arreglan la API.
Revisar ambiente Abre el ambiente activo, para revisar la URL base.

Al final, el panel te recuerda que puedes copiar un paso como cURL y probarlo en tu terminal, donde CORS no aplica. Mira Network.