---
title: "Recibo HTML o "Error interno" en vez de JSON"
description: "Diagnóstico de las respuestas 500 con página HTML y de las respuestas que llegan sin cuerpo."
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-09-11"
last_update: "2026-09-11"
time_minutes: 2
draft: false
unlisted: false
url: "https://www.apigateway.cl/docs/solucion-de-problemas/respuestas-html-y-error-interno"
---

# Recibo HTML o "Error interno" en vez de JSON

## Síntoma: HTTP 500 con una página HTML

La respuesta llega con `content-type: text/html` y una página titulada **"Error interno"**, en lugar de un JSON. Las causas, en orden de frecuencia:

**1. La estructura del request no es la que espera el recurso.** Es la causa más común. Si el JSON pasa las validaciones básicas pero un campo va en el nivel equivocado o con un valor inválido, la operación puede fallar de forma no controlada. Revisa [Errores 400: estructura del request](https://www.apigateway.cl/docs/solucion-de-problemas/errores-de-estructura-del-request).

**2. El proxy no está bien configurado.** Revisa [Errores de proxy](https://www.apigateway.cl/docs/solucion-de-problemas/errores-de-proxy).

**3. Estás usando un recurso para algo que no hace.** Por ejemplo, los recursos del Portal MiPYME solo generan **borradores**: intentar emitir un documento real por esa vía no va a funcionar, y las lecturas del mismo producto seguirán respondiendo `200`. Ese contraste —todas las lecturas bien, la escritura con `500`— es la firma de este caso.

**4. Una intermitencia puntual del recurso.** Ocurre y la corregimos. Un caso real: el recurso de PDF de BHE recibidas devolvía `500` con la consulta correctamente formada, y se corrigió del lado de la plataforma.

## Síntoma: HTTP 404 con una página HTML

La ruta no existe. Revisa:

- **La URL base**: `https://app.apigateway.cl/api/v2/`, no `apigateway.cl` ni `www.apigateway.cl`.
- **Una barra final de más**: un `/` sobrante antes de los parámetros de query, como `.../225415/?fecha_emision=...`, hace que la ruta no calce.
- **El formato del período**: `202605`, no `2026-05`.
- **Que el recurso exista en la versión que usas**: los paths de `/api/v1` no existen en `/api/v2` y viceversa.

## Síntoma: la respuesta llega vacía aunque el Content-Length indique contenido

Se ha reportado en recursos de Legacy consultados de forma incorrecta. En los casos revisados, la causa fue la forma de consumir el recurso: método de autenticación equivocado o estructura del body que el recurso no espera. Contrasta tu request con el ejemplo de la [documentación de la API V1](https://www.apigateway.cl/docs/api-v1).

## Antes de reportarlo

Si tras revisar la documentación el error persiste, [genera un ticket](https://www.apigateway.cl/help) con el **cURL real** que estás enviando, la respuesta exacta y la fecha y hora de los intentos. Revisa [qué datos enviar](https://www.apigateway.cl/faq/soporte-y-atencion/que-datos-debo-enviar-al-reportar-un-problema).



---
Última actualización el 11/09/2026