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.

2. El proxy no está bien configurado. Revisa 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.