Gladtolink blog

Añadir valores a una etiqueta

En este tutorial vamos a aprender como realizar una llamada a nuestra API, que provocará la creación de valores en una etiqueta determinada.

Antes de nada será necesario conseguir nuestro access_token. Para ello mostramos como hacerlo en el siguiente tutorial: Login

También necesitamos el identificador de nuestra etiqueta, la etiqueta sobre la cual queremos crear nuevos valores, para obtener tal identificador tendremos que proceder de la siguiente manerea:

1) Iremos a la etiqueta en concreto y clicaremos en la parte de sus valores

login done

2) En la parte superior derecha podemos ver un icono a modo de enchufe, clicaremos en dicho icono

login done

3) En la siguiente ventana podremos ver el identificador que deseamos ya con el formato habitual de una llamada a nuestra api.

modal clipboard

Ahora ya tenemos las el access_token y el identificador de la etiqueta y podemos proceder a configurar la llamada:

  • Petición POST a la siguiente url: https://www.gladtolink.com:8080/api/Tag/{tagId}/stats/CreateUpdateDonde tagId es el identificador de nuestra etiqueta, es decir, que si sustituimos quedaría de la siguiente forma:

    https://www.gladtolink.com:8080/api/Tag/cfcf0472-f3e4-4086-a49d-c0826435e9d6/stats/CreateUpdate/

    La llamada al createUpdate pondra nuevas valores si no existían de antes, y en caso de que ya existierán los modificará.

  • Header necesitaremos añadir nuestro Token de la siguiente manera:header crear valores

    ** Véase que la autentificación es del tipo BearerToken por esta razón en el value ponemos Bearer + uniqueId de la etiqueta (tal como esta remarcado en la imagen).

  • Body: En el body especificaremos que será de tipo raw y JSON(application/json). Y especificaremos un array en formato json con los valores. El array a introducir debe tener la siguiente esctructura:
    `
    {
    «isDefault»: false,
    «name»: «Value 1»,
    «description»: «Description 1»,
    «data1»: «sample string 5»,
    «data2»: «sample string 6»,
    «data3»: «sample string 7»,
    «data4»: «sample string 8»,
    «data5»: «sample string 9»,
    «data6»: «sample string 10»,
    «data7»: «sample string 11»,
    «data8»: «sample string 12»,
    «data9»: «sample string 13»,
    «data10»: «sample string 14»,
    «data11»: «sample string 15»,
    «data12»: «sample string 16»,
    «data13»: «sample string 17»,
    «data14»: «sample string 18»,
    «data15»: «sample string 19»,
    «data16»: «sample string 20»,
    «data17»: «sample string 21»,
    «data18»: «sample string 22»,
    «data19»: «sample string 23»,
    «data20»: «sample string 24»
    },
    {
    «isDefault»: false,
    «name»: «Value 2»,
    «description»: «Description 2»,
    «data1»: «sample string 5»,
    «data2»: «sample string 6»,
    «data3»: «sample string 7»,
    «data4»: «sample string 8»,
    «data5»: «sample string 9»,
    «data6»: «sample string 10»,
    «data7»: «sample string 11»,
    «data8»: «sample string 12»,
    «data9»: «sample string 13»,
    «data10»: «sample string 14»,
    «data11»: «sample string 15»,
    «data12»: «sample string 16»,
    «data13»: «sample string 17»,
    «data14»: «sample string 18»,
    «data15»: «sample string 19»,
    «data16»: «sample string 20»,
    «data17»: «sample string 21»,
    «data18»: «sample string 22»,
    «data19»: «sample string 23»,
    «data20»: «sample string 24»
    }
    `

    De tal forma que quedaría como en la siguiente imágen:

    send valores

    Una vez introducido, le daremos a Send. Si todo se ha configurado correctamente, al refrescar la plataforma podrá ver los nuevos valores en la etiqueta.