En esta sección se muestra como utilizar la API con ejemplos
de diferentes casos de uso.
Aquí puedes descargar la API, los ejemplos de casos de uso y acceder a la documentación:
En
Hrider-API-UseCases.zip
puedes encontrar el código fuente con ejemplos de casos de uso. El proyecto utiliza
Eclipse Jersey como cliente REST. Además
de las dependencias incluidas en el fichero Maven
pom.xml necesitarás añadir localmente la librería
Hrider-API.jar
El fichero
pom.xml incluye:
<dependencies>
<dependency>
<groupId>org.glassfish.jersey.core</groupId>
<artifactId>jersey-client</artifactId>
<version>2.30.1</version>
</dependency>
<dependency>
<groupId>org.glassfish.jersey.inject</groupId>
<artifactId>jersey-hk2</artifactId>
<version>2.26</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
</dependency>
<dependency>
<groupId>org.glassfish.jersey.media</groupId>
<artifactId>jersey-media-json-jackson</artifactId>
<version>2.30</version>
</dependency>
<dependency>
<groupId>org.glassfish.jersey.media</groupId>
<artifactId>jersey-media-multipart</artifactId>
<version>2.31</version>
</dependency>
</dependencies>
El token y la URL de conexión se configuran en el fichero
src/main/resources/config.properties.
Aquí puedes consultar cómo obtener una API key
, sustituye
yourAuthApiKey con la clave obtenida:
api.token=bearer yourAuthApiKey
api.uri=https://dev.hrider.net/api
Ahora ya estamos listos para obtener el punto de anclaje principal.
Utilizaremos las clases
ApiClient y
HRiderService que incluyen todo el
código necesario para crear el cliente Jersey. El código básico para la versión "v1"
sería:
ApiClient client = new ApiClient();
HRiderService service = new HRiderService(client);
Root root = service.get(Root.class, new Link("v1"));