Suministro y proveedor correctos
Envía numero_suministro al endpoint que corresponde al servicio: /api/v1/recibos/luz-del-sur o /api/v1/recibos/sedapal. El número por sí solo no identifica de forma universal a todos los proveedores; comprueba el servicio antes de consultar.
Consulta únicamente suministros y recibos para los que tengas autorización. Un archivo de servicio puede contener información del titular y del domicilio; evita compartirlo mediante enlaces públicos o guardarlo en herramientas de analítica.
Cómo leer el archivo
El contrato normalizado utiliza content_base64 y mime_type. En estas operaciones el tipo publicado es image/jpeg. Decodifica el contenido en tu servidor y trata los archivos como datos, sin ejecutarlos. No guardes la cadena Base64 completa en los logs.
No presentes el resultado como un PDF si el tipo MIME indica una imagen. Si tu aplicación necesita otro formato, añade una conversión propia y conserva la distinción entre el archivo obtenido y el generado por tu sistema.
Alcance y disponibilidad
La API consulta al proveedor JSON.pe y su cobertura depende de la información disponible. No paga recibos, no modifica contratos y no ofrece descarga masiva de suministros. Un resultado ausente debe mostrarse como tal.
El plan de cuenta permite consultar estos endpoints junto con el resto del catálogo. Una operación exitosa consume un crédito y los errores de la fuente liberan la reserva de cuota.
Preguntas frecuentes
¿Se incluye Sedapal?
Sí. Cuenta con su propio endpoint de consulta por número de suministro.
¿La respuesta es un enlace público?
No. El archivo se devuelve dentro de la respuesta autenticada como contenido Base64.