Estándares

OPENAPI

Estándares para interfaz de servicios

La especificación Open API, originalmente conocida como la especificación Swagger; es una especificación para interfaces procesables por máquinas, descritas en archivos para ser producidas, consumidas y virtualizadas en servicios web RESTful.
Originalmente parte de framework Swagger, se convirtió en un proyecto separado en 2016, vigilado por la iniciativa OpenAPI, una colaboración de open source de la Linux Foundation.

Por tanto las interfases RESTful diseñadas dentro de nuestras soluciones se alinean a este estándar para garantizar la portabilidad entre diferentes API Managers. De igual forma, BIAN emite sus interfaces por medio de archivos Swagger; que también están alienados a este estándar.La especificación que utilizamos actualmente es la Open API 3.0.2, la cual se versiona utilizando Semantic Versioning 2.0.0 https://semver.org/spec/v2.0.0.html (semver) y sigue la especificación semver.
Sobre todo utilizamos el principio HATEOAS, Hypermedia As The Engine Of Application State (hipermedia como motor del estado de la aplicación). Definido como cuando el servidor nos devuelve la representación de un recurso (JSON, XML); parte de la información devuelta serán identificadores únicos en forma de hipervínculos a otros recursos asociados.
La restricción HATEOAS propone que el cliente y el servidor se comuniquen completamente utilizando el hipermedia.

Descubre cómo podemos ayudarte

Completa el formulario y solicita más detalles sobre nuestra plataforma o servicios.

Scroll al inicio