Ir al contenido principal

Obtener Version - [version]

🧾 Descripción

Obtiene la versión actual de una aplicación móvil específica.
El servicio valida si el identificador de la app existe y, de ser así, devuelve la versión correspondiente.

Este endpoint se usa para:

  • Mostrar la versión actual al usuario

  • Verificar actualizaciones desde la app móvil

  • Controlar múltiples aplicaciones dentro del mismo backend


🚀 Endpoint


POST /version

La ruta final dependerá del archivo de rutas (routes/api.php).


🔐 Seguridad

  • Sin autenticación explícita

  • Normalmente accesible para todas las apps móviles


📥 Request Body

{ "app": "string" }

Campos

Campo Tipo Requerido Descripción
app string Identificador de la aplicación cuya versión se desea consultar.

📤 Responses

✔️ 200 – App encontrada (Versión obtenida)

{ "valor": true, "msn": "Versión del app MiApp: 1.0.5", "version": "1.0.5" }

El nombre mostrado proviene de: $name_app = $this->apps[$app];

La versión proviene de: $versiones = $this->data(); $version = $versiones[$app];


❌ 404 / 200 – App no existente

 

{ "valor": false, "msn": "No existe esa app" }

Nota: El método devuelve 200 OK incluso cuando la app no existe.
(Esto es comportamiento actual del código.)


🧩 Lógica Interna

  1. Recibe el parámetro app.

  2. Obtiene todas las versiones desde $this->data()
    (método interno que no está mostrado pero retorna un array asociativo).

  3. Valida si la clave app existe en el array versiones:

    • No existe → error

    • Existe → procede

  4. Obtiene el nombre de la app desde: $this->apps[$app]

  5. Obtiene la versión asociada: $versiones[$app]

  6. Devuelve la versión actual en el message.


📚 Schema

Request

{ "app": "string" }

Response

{ "valor": "boolean", "msn": "string", "version": "string (opcional)" }

🧪 Ejemplo de Uso (curl)

curl -X POST https://midominio.com/api/version \ -H "Content-Type: application/json" \ -d '{"app":"shalom_app"}'

Respuesta esperada:

{ "valor": true, "msn": "Versión del app Shalom App: 3.1.4", "version": "3.1.4" }