Geração de Código de Cliente em Test & Doc APIS

54

Este novo utilitário consiste em um editor de código de cliente para as APIs das Ontologias nas principais linguagens de programação, assim só teremos que copiar o código que ele gera e inseri-lo em nossos aplicativos.

Para isso devemos acessar a API da Ontologia que queremos invocar. Neste exemplo, será “APARCAMIENTOSPUBLICOSMADRIDES”. Então vamos acessar o menu “API MANAGER” e o submenu “APIs”:

Image 002

Uma vez aqui, vamos para a guia “Minhas inscrições”:Image 005

E nós escolhemos a API que queremos testar. E clique no botão “Test & Doc”:Image 008Aqui temos informações sobre a API e as funções que ela expõe para o seu consumo. Vamos escolher a função “getAll”:Image 011

Em seguida, mostramos as informações referentes a essa função, e na parte direita aparecerá um menu suspenso chamado “Invocação para a API”, no qual escolheremos o idioma que queremos usar para invocar a função:Image 014

E isso gerará o código necessário para invocar a função. Teremos apenas que completar este código usando o token do usuário com o qual estamos logados na parte “x-sofia2-apikey”:Image 017

Criei uma página de exemplo em HTML usando JQuery, para inserir o código que nos gera o método da API, o código HTML usado para o exemplo seria:

<code>

<!DOCTYPE html>
<html>

<head>
<meta charset=”UTF-8″>
<title>Test API</title>
http://code.jquery.com/jquery-2.2.3.min.js

$(document).ready(function() {
$(“#myButton”).click(function() {

var settings = {
“async”: true,
“crossDomain”: true,
“url”: “https://sofia2.com/sib-api/api/v1/aparcamientospublicosmadrides/getAll&#8221;,
“method”: “GET”,
“headers”: {
“x-sofia2-apikey”: “********************”
}
}

$.ajax(settings).done(function (response) {
console.log(response);
var num = response.data.length;
$(“#helloWorldDiv”).html(“Request URL: https://sofia2.com/sib-api/api/v1/aparcamientospublicosmadrides/getAll
Num Result: ” + num);

});

});
});

</head>

<body>
<button id=”myButton”>Test API</button>
</br>
</br>

</body>

</html>

</code>

O resultado pode ser algo assim:

Image 028

Geração de Código de Cliente em Test & Doc APIS

Client Code Generation in Test&Doc APIs

54

This new utility consists of a client code editor for the APIs of the Ontologies in the most popular programming languages, in this way we will only have to copy the code that it generates and insert it in our applications.

For this we must access the API of the Ontology that we want to invoke. In this example, it will be “APARCAMIENTOSPUBLICOSMADRIDES “. So we will access the “API MANAGER” menu, and the “APIs” submenu:

Image 001

Once here, we go to “My Subscriptions” tab:Image 004

We choose the API that we want to test. And click on the “Test & Doc” button:Image 007

Here we have information about the API and the functions it exposes for its consumption. We are going to choose the “getAll” function:

Image 010

Next we are shown the information referring to that function, and on the right part a drop-down menu called “API Invocation” will appear, in which we will choose the language we want to use to invoke the function:

Image 013

And this will generate the piece of code needed to invoke the function. We will only have to complete this code using the logged user’s token in the “x-sofia2-apikey” part:

Image 016

I have created a sample page in HTML using JQuery, to insert the code that generates us for the API method, the HTML code used for the example would be:

<code>

<!DOCTYPE html>
<html>

<head>
<meta charset=”UTF-8″>
<title>Test API</title>
http://code.jquery.com/jquery-2.2.3.min.js

$(document).ready(function() {
$(“#myButton”).click(function() {

var settings = {
“async”: true,
“crossDomain”: true,
“url”: “https://sofia2.com/sib-api/api/v1/aparcamientospublicosmadrides/getAll&#8221;,
“method”: “GET”,
“headers”: {
“x-sofia2-apikey”: “********************”
}
}

$.ajax(settings).done(function (response) {
console.log(response);
var num = response.data.length;
$(“#helloWorldDiv”).html(“Request URL: https://sofia2.com/sib-api/api/v1/aparcamientospublicosmadrides/getAll
Num Result: ” + num);

});

});
});

</head>

<body>
<button id=”myButton”>Test API</button>
</br>
</br>

</body>

</html>

</code>

result could be something like this:

Image 028

Client Code Generation in Test&Doc APIs

Generación Código Cliente en TEst&Doc APIS

54

Esta nueva utilidad consiste en un editor de código cliente para las APIs de las Ontologías en los principales lenguajes de programación, de esta forma solo tendremos que copiar el código que genera e insertarlo en nuestras aplicaciones.

 

Para ello debemos acceder a la API de la Ontología que queremos invocar. En este ejemplo será “AparcamientoPublicosMadrides”. Así que accederemos al menú de “API MANAGER”, y al submenú “APIs”:Image 003

Una vez aquí, vamos a la pestaña de “Mis Suscripciones”:Image 006

Y elegimos la API que queremos probar. Y clickamos sobre el botón “Test & Doc”:Image 009

Aquí tenemos información de la API y de las funciones que expone para su consumo. Nosotros vamos a elegir la función “getAll”:Image 012

A continuación se nos muestra la información referente a dicha función, y en la parte derecha aparecerá un menú desplegable llamado “Invocación al API”, en el elegiremos el lenguaje que queremos usar para invocar a la función:Image 015

Y esto generará el trozo de código necesario para invocar a la función. Solo tendremos que completar dicho código usando el token del usuario con el que estamos logados en la parte del “x-sofia2-apikey”:Image 018

He creado una pagina de ejemplo en HTML usando JQuery, para insertar el código que nos genera para el método del API,  el codigo HTML utilizado para el ejemplo seria:

<code>

<!DOCTYPE html>
<html>

<head>
<meta charset=”UTF-8″>
<title>Test API</title>
http://code.jquery.com/jquery-2.2.3.min.js

$(document).ready(function() {
$(“#myButton”).click(function() {

var settings = {
“async”: true,
“crossDomain”: true,
“url”: “https://sofia2.com/sib-api/api/v1/aparcamientospublicosmadrides/getAll&#8221;,
“method”: “GET”,
“headers”: {
“x-sofia2-apikey”: “********************”
}
}

$.ajax(settings).done(function (response) {
console.log(response);
var num = response.data.length;
$(“#apiTestDiv”).html(“Request URL: https://sofia2.com/sib-api/api/v1/aparcamientospublicosmadrides/getAll
Num Result: ” + num);

});

});
});

</head>

<body>
<button id=”myButton”>Test API</button>
</br>
</br>

</body>

</html>

</code>

 

resultado sería asi:

Image 028

Generación Código Cliente en TEst&Doc APIS