REST
in package
Clase REST.
- Gestiona la comunicación externa mediante peticiones HTTP (cURL). Se encarga de consumir APIs de terceros (NASA, Wikipedia) y la propia API interna de la aplicación, decodificando las respuestas JSON e instanciando los objetos necesarios.
Tags
Table of Contents
Methods
- apiNasa() : FotoNasa
- Consume la API APOD (Astronomy Picture of the Day) de la NASA.
- apiVolumenNegocioDepartamento() : float|null
- Consume la API REST interna para consultar el volumen de facturación.
- apiWikipediaEfemerides() : EventoHistorico
- Consulta la API pública de Wikipedia para extraer efemérides históricas.
- descargarImagenBase64() : string|null
- Descarga y serializa un archivo de imagen en una cadena codificada Base64.
Methods
apiNasa()
Consume la API APOD (Astronomy Picture of the Day) de la NASA.
public
static apiNasa(string $sFecha) : FotoNasa
- Realiza una petición cURL utilizando la API Key definida en configuración. Si la respuesta es exitosa y es una imagen, descarga y codifica la imagen en Base64 para incrustarla directamente. En caso de error de conexión o API, devuelve un objeto con datos y recursos gráficos por defecto.
Parameters
- $sFecha : string
-
Fecha de consulta en formato 'YYYY-MM-DD'.
Return values
FotoNasa —Objeto instanciado con los datos astronómicos o con los de fallback en caso de error.
apiVolumenNegocioDepartamento()
Consume la API REST interna para consultar el volumen de facturación.
public
static apiVolumenNegocioDepartamento(string $codDepartamento) : float|null
- Envía una solicitud GET segura inyectando la clave autorizada (API_KEY_PROPIA) a través de los Custom HTTP Headers (x-api-key) para evitar la exposición en la URL.
Parameters
- $codDepartamento : string
-
Código identificador único del departamento.
Return values
float|null —Devuelve la cifra monetaria en formato float, o null si la autorización falla o no existe.
apiWikipediaEfemerides()
Consulta la API pública de Wikipedia para extraer efemérides históricas.
public
static apiWikipediaEfemerides(string $sMes, string $sDia) : EventoHistorico
- Solicita los eventos ("On this day") que sucedieron en el mes y día especificados. Extrae de forma aleatoria uno de los múltiples eventos devueltos para añadir variedad.
Parameters
- $sMes : string
-
Mes numérico con formato de dos dígitos (ej. '02').
- $sDia : string
-
Día numérico con formato de dos dígitos (ej. '17').
Return values
EventoHistorico —Objeto con la información del evento, o un objeto predeterminado de error.
descargarImagenBase64()
Descarga y serializa un archivo de imagen en una cadena codificada Base64.
private
static descargarImagenBase64(string $sUrl) : string|null
- Es una función auxiliar privada. Obtiene el tipo MIME original de la imagen
y genera una cadena lista para ser insertada en el atributo "src" de la etiqueta
.
Parameters
- $sUrl : string
-
Enlace directo y público a la imagen a descargar.
Return values
string|null —Devuelve la cadena (ej. data:image/jpeg;base64,iVBORw0KG...) o null si falla.