Variables Webapp

Cuando su webapp necesita recordar algo entre una visita y otra —el URL de un servicio externo, un umbral de descuento, un texto de bienvenida— las variables para webapps son el lugar ideal para guardarlo. Cada variable almacena una configuración en modo de texto y queda totalmente accesible desde el API, de modo que cualquier aplicación externa hecha a la medida puede consultarla, editarla o eliminarla si cuenta con los permisos suficientes. Recuerde que el valor viaja como texto: es responsabilidad del desarrollador interpretar esa información antes de utilizarla.

El listado de variables es el siguiente:

Nueva variable para webapp

Hay campos adicionales que pueden servir para tipificar el valor de la variable, los únicos campos oblicagorios son nombre, clase y valor.

Editar variable para webapp

Es el mismo formulario que para crear una nueva variable.

Detalles de una variable para webapp

El detalle me muestra el valor y todos los campos adicionales de la webapp.

Con sus variables guardadas, sus webapps pueden leer y actualizar sus propias configuraciones sin necesidad de tocar el código cada vez. El paso natural que sigue es consumir esas variables desde su aplicación a la medida, o incrustarla dentro de Zauru para manejarlo todo en un mismo lugar.

API (llamadas desde sistemas externos)

Solicitar listado de variables

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/apps/webapp_vars.json

Esto devolverá un JSON similar a este:

[
  {
    "created_at":"2019-07-16T19:08:53Z",
    "creator":"Programador Estrella",
    "description":"prueba",
    "entity_id": 1,
    "id":1,
    "kind":"Entero",
    "name":"primera_variable",
    "updated_at":"2019-07-16T19:08:53Z",
    "user_id":null,
    "value":"319"
  },
  {
    "created_at":"2019-07-16T20:05:49Z",
    "creator":"Programador Estrella",
    "description":"segunda prueba",
    "entity_id": 1,
    "id":2,
    "kind":"Cadena",
    "name":"segunda_variable",
    "updated_at":"2019-07-16T20:05:49Z",
    "user_id":null,
    "value":"LSI301899DKMCIS"
  }
]

Ver el detalle de una variable

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/apps/webapp_vars/2.json

Esto devolverá un JSON similar a este:

{
  "created_at":"2019-07-16T20:05:49Z",
  "creator":"Programador Estrella",
  "description":"segunda prueba",
  "entity_id": 1,
  "id":2,
  "kind":"Cadena",
  "name":"segunda_variable",
  "updated_at":"2019-07-16T20:05:49Z",
  "user_id":null,
  "value":"LSI301899DKMCIS"
}

Crear una nueva variable

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X POST \
  -d '{
    "variable": {
      "name": "tercera_variable",
      "kind": "Entero",
      "value": "12233",
      "description": "otra prueba mas"
    }
  }' \
  https://app.zauru.com/apps/webapp_vars.json

Esto devolverá un JSON similar a este:

{
  "created_at":"2019-07-16T20:05:49Z",
  "creator":"Programador Estrella",
  "description":"segunda prueba",
  "entity_id": 1,
  "id":3,
  "kind":"Entero",
  "name":"tercera_variable",
  "updated_at":"2019-07-16T20:05:49Z",
  "user_id":null,
  "value":"12233"
}

Editar una variable

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PUT \
  -d '{
    "variable": {
      "name": "tercera_variable_v2",
      "kind": "Entero",
      "value": "122334",
      "description": "otra prueba mas"
    }
  }' \
  https://app.zauru.com/apps/webapp_vars/3.json

Esta llamada no devolverá nada

Borrar una variable

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X DELETE \
  https://app.zauru.com/apps/webapp_vars/3.json

Esta llamada no devolverá nada

Nueva variable (prellenado)

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/apps/webapp_vars/new.json

Esto devolverá un JSON similar a este:

{
  "id": null,
  "name": null,
  "value": null,
  "kind": null,
  "user_id": null,
  "entity_id": 1,
  "description": null,
  "creator": null,
  "created_at": null,
  "updated_at": null
}

Editar variable

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/apps/webapp_vars/3/edit.json

Esto devolverá un JSON similar a este:

{}