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
2) En la parte superior derecha podemos ver un icono a modo de enchufe, clicaremos en dicho icono
3) En la siguiente ventana podremos ver el identificador que deseamos ya con el formato habitual de una llamada a nuestra api.
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:
** 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:
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.