Una vez hayas descargado tus API keys y el cliente de Bookitit, lo primero que haremos será comprobar su funcionamiento.

A continuación crearemos una nuevo paquete lib y copiamos en su interior el cliente para Java.

La clase CRestClient tiene las siguiente propiedades:

private String _sPublicKey = «»;
private String _sPrivateKey = «»;
private String _sRoot=»app.bookitit.com/»;
private String _sVersion=»11″;

A continuación editaremos el archivo CRestClient.java del directorio lib e insertaremos las claves conseguidas de Bookitit.com en los atributos _sPublicKey y _sPrivateKey. Esto es muy importante hacerlo ya que se utilizará en cada petición.

El atributo _sRoot indica la url donde está alojado Bookitit y la versión indicará la versión de API que vamos a usar. Actualmente existen varias versiones de API así que tendrás que descargarte el cliente correcto para la versión que vayas a utilizar.

Recuerda que la clave privada nunca se transmitirá, se utiliza para crear un hash que será el emitido y utilizado como si fuera una contraseña.

Ahora para comprobar todo esto, nosotros hemos creado una clase de Java TestApp con el siguiente código:

public class TestApp {
  public static void main(String[] args) throws Exception{
    CRestClient oRestClient = new CRestClient();
    String sReturn = oRestClient.testConnection(«yourtext», «json», true);
    System.out.println(sReturn);
  }
}

El texto que envíes en “yourtext” asegúrate de que no contenga espacios. Esto te debería devolver algo así:

{«connection»:{«status»:»true»,»echovalue»:»yourtext»}}

Si hay algún problema con las claves de autenticación te devolverá una respuesta del siguiente estilo:

“This api connection site needs a true authentication. You can not pass.“

Los parámetros para todas las funciones que ofrece el cliente CRestClient suelen tener dos parámetros finales comunes. El primero indicará en que formato quieres que te devuelva el valor “xml” o “json” el segundo si la petición se hará por “http”(false) o “https”(true).

Ver detalle de la función testconnection (enlace a la API función testconnection).