En la release 2.9 de Sofia2 se incluye la nueva versión del API Manager.
A partir de una ontología de Sofia2 se puede crear un API completa (con todos los métodos de inserción, actualización, consulta,..). Queda reflejado en los distintos interfaces de la aplicación:
La pantalla de invocación a las APIs quedaría:
Resumiendo, se incluyen las siguientes operaciones:
- INSERT:
Operación con método HTTP POST sobre /sofia2.com/sib-api/api/{VERSION}/{API]/ enviando en el body de la petición una instancia de la ontología disponibilizada.
“Feed”: { “assetId”: “1”,
“assetType”: “CuadroElectrico”,
“assetSource”: “CuadroEntrada”,
“type”: “VIRTUAL”,
“timestamp”: {“$date”: “2014-05-19T13:57:39.342Z”}}
- UPDATE:
Operación con método HTTP PUT sobre /sofia2.com/sib-api/api/{VERSION}/{API]/ enviando en el body de la petición un objeto con:
– ObjectId de la instancia a actualizar de la BTDR
– Nuevos datos de la instancia en el mismo formato descrito en el esquema de su ontología.
{“_id” : {“$oid” : “5388701fdef773767496e05d”} ,
“Feed”: {“assetId” : “2” ,
“assetType” : “CuadroElectrico” ,
“assetSource” : “CuadroEntrada” ,
“type” : “VIRTUAL” ,
“timestamp” : { “$date” : “2014-05-19T13:57:39.342Z”}}}
- DELETE:
Operación con método HTTP DELETE sobre /sofia2.com/sib-api/api/{VERSION}/{API]/ enviando en el body de la petición un objeto con:
– ObjectId de la instancia a eliminar de la BTDR.
{“_id” :{ “$oid” : “5388701fdef773767496e05d”}}
- QUERY:
Se implementan dos métodos:
– Operación con método HTTP GET sobre /sofia2.com/sib-api/api/{VERSION}/{API]/ enviando en el body de la petición un objeto con Id de la instancia a actualizar de la BTDR
– Operación con método HTTP GET sobre /sofia2.com/sib-api/api/{VERSION}/{API]/ enviando en el body de la petición un objeto con:
$targetdb: Base de datos sobre la que se realizará la consulta: BDTR o BDH
$filter: Consulta sql a realizar sobre la BBDD.
- QUERY OPS:
Operación con método HTTP GET sobre /sofia2.com/sib-api/api/{VERSION}/{API]/ enviando en el body de la petición un objeto con:
$queryType:Tipo de consulta.
“SQLLIKE”
$query: Consulta SQL a realizar sobre la BBDD. Se incluyen INSERT, UPDATE y DELETE.