---
title: "¿Cómo usar API Cliente de Android?"
canonical: "https://onesaitplatform-es.refined.site/space/DOC/2215908047/%C2%BFC%C3%B3mo%20usar%20API%20Cliente%20de%20Android%3F"
format: markdown
---
> Macro (toc)

# Introducción 

La primera versión de la API de Android para la plataforma onesait está disponible para los desarrolladores de móviles. Esta API da a los desarrolladores para móviles las capacidades de la plataforma al permitirles insertar datos de sus aplicaciones en la plataforma.

![image](media://e6e5015c-4904-49bc-9021-b6b4750dc698)

En esta versión hemos implementado tres operaciones sobre la plataforma, todas ellas usando comunicación REST:

- **JOIN: **Esta operación permite al dispositivo obtener una sesión en la plataforma. Resulta necesario para realizar una inserción con la siguiente operación. La salida de esta operación es una **sessionKey.**
- **INSERT:** Esta operación permite la inserción en una Ontología. Se necesita una **sessionKey** y una instancia válida de Ontología para realizar esta operación.
- **LEAVE:** Esta operación cierra la sesión actual.

# Uso

Para poder utilizar la API, es necesario añadir estas líneas al fichero build.gradle de Android Studio: La primera dentro de la sección de **repositories** y la segunda dentro de **dependencies**


Después de la sincronización de Gradle, puedes usar la clase **RestClient** para comunicarte con la plataforma:

![image](media://19ac8f7d-409c-4f19-9d45-43e47cff02f7)

El constructor requiere tener un Cliente Digital válido (clientPlatform) registrado en la plataforma, y su token asociado. El Cliente Digital es la interfaz cliente de la plataforma, que sirve como punto de entrada al sistema y a las ontologías seleccionadas para los dispositivos permitidos. Para llegar a la página del Cliente, sólo hay que navegar hasta:

![image](media://7bb46f27-939c-4e76-b412-41cbe805b2db)

Dentro del menú de creación, debes darle un nombre a tu cliente y añadir las ontologías a las que quieres acceder a través del cliente. Se generará un token, y ése es el token que la API necesita para acceder a la plataforma:

  


![image](media://fe7ede03-e005-4f98-be57-fa6b7e5bbc37)

Si quieres insertar datos en una Ontología, tendrás que crear una y asociarla a tu IoTClient, que has creado recientemente.

Una vez que los elementos de la plataforma estén listos, puedes ir a Android Studio y empezar a desarrollar tu aplicación. Lo primero que necesitarás hacer es instanciar los parámetros necesarios para crear tu instancia RestClient:

![image](media://9a9d3c5a-92d8-4118-8b71-fb39c958cbee)

Y entonces puedes instanciar el objeto RestClient:

![image](media://7900d845-551a-47c8-b524-4989dbc9012e)

  


Una vez que esto está hecho, es bastante sencillo implementar cualquiera de las tres operaciones definidas. Por ejemplo, con este simple y breve código, estarás realizando un JOIN y un INSERT en sólo tres líneas:

![image](media://26d62cae-7c45-4731-acb3-c883e5acc526)

Para insertar, es necesario proporcionar una instancia de ontología en forma de String y que se ajuste a la plantilla. La mayoría de los marcos comunes de JSON, como GSON y Jackson, permiten una fácil composición y encadenamiento de objetos, pero para este ejemplo, construye un String personalizado como éste:

![image](media://c9c9e239-a162-43cf-bffe-3d41e344c1c4)

  


Éste se ajusta al esquema original JSON de la instancia de Ontología :

***{"androidIoTFrame":{ "geometry":{"type":"Point", "coordinates":[9,19.3]},"email":"string","accelX":28.6,"accelY":28.6,"accelZ":28.6,"event":true}}***

Si tienes algún problema con la API, por favor háznoslo saber en [support@onesaitplatform.com](mailto:support@onesaitplatform.com).