Introduccion A Apis Y Web Services

Pequeño documento sobre APIs |
Interficies de Programación de Aplicaciones |
Quing Wen He |

Tabla de contenido
¿Qué es una API? 3
¿Para qué sirve una API? 3
¿Por qué necesito una API? 3
Caracteristicas basicas de una API 3
Ventajas y desventajas de las APIs 3
Principiso de construcción de APIs 4
Tipos de APIs y sus caracteristicas 4
OOP APIs 4
APIs de librerias yframeworks 4
APIs de protocolos 4
comparticion y reutilizacion de apis mediante VM 4
APIs web 4
Glosario 4
Bibliografia 4

¿Qué es una API?
Es una capa de abstracción que permite que aplicaciones no relacionadas puedan usar comunicarse, interaccionar e intercambiar recursos y servicios.
Una API es un grupo de funciones que permiten que desarrolladores puedan acceder a tus datos yfuncionalidades sin disponer del código fuente ni saber de la implementación interna.
El termino API puede ser usado para referirse a una interficie, a una única función o a un conjunto de APIs proveídos por una organización. El ámbito de significado es determinado por el contexto de uso

¿Para qué sirve una API?
Una API permite utilizar extender las funcionalidades y servicios de una aplicación comosi fuera una caja negra sin tener que preocuparnos por su implementación interna.
Se puede ver una API como una extensión de servicios.
¿Por qué necesito una API?
Una API es especialmente necesaria cuando podemos evitarnos implementarlo todo desde el principio. Librerías que ofrecen lo que buscamos, utilizando su API nos permite ahorrarnos los detalles de su implementación y usarlodirectamente.
Disponer de una API es necesaria si queremos permitir que otras aplicaciones/servicios puedan usar nuestras funcionalidades.
Caracteristicas basicas de una API
Una buena API ha de ser abstracta, fiable, de uso general.
Al elegir usar una API se debe llegar a un cierto equilibrio entre su potencia, simplicidad y pérdida de flexibilidad. Cuanto más alto sea el nivel de la API menosflexibilidad vamos a disponer, lo mismo con su eficiencia.
Las APIs normalmente incluyen una descripción de todas las funciones/rutinas/funcionalidades que ofrece. Esta documentación describe cómo usar las funciones, el número y el tipo de parámetros que se le pueden pasar, el tipo del valor de retorno. El comportamiento es descrito en lenguaje natural.

Ventajas y desventajas de las APIs
Las APIsdependientes del lenguaje tienen la limitación de estar disponibles utilizando la sintaxis y los elementos disponibles de un lenguaje en particular lo que la hace mas cómodo de utilizar.
Dependientes del lenguaje |
Ventajas | Desventajas |
Fácil de utilizar | Disponibles únicamente utilizando la sintaxis y elementos disponibles del lenguaje |
Las APIs independientes del lenguajeIndependientes del lenguaje |
Ventajas | Desventajas |
| |
 
Principios de construcción de APIs
Lo más importante de una API es su documentación. La documentación ha de ser clara y concisa, no ha de revelar su implementación pero si describir las funcionalidades, limitaciones, excepciones y otros detalles importantes para el correcto funcionamiento de las funciones ofrecidas.
Cada funcionalidadCaracteristicas de una buena API
* Fácil de aprender
* Fácil de usar, incluso sin documentación.
* Difícil de hacer un mal uso
* Fácil de leer y mantener código que lo usa
* Suficientemente potente para satisfacer los requisitos
* Fácil de extender
* Apropiado para la audiencia
Principios generales
La API tiene que hacer una cosa y la tiene que hacer bien.
LaFuncionalidad ha de ser fácil de explicar. Si es difícil ponerle un nombre es una mala señal
Una API tiene que ser lo mas pequeña posible pero no la más pequeña
Tiene que satisfacer sus requisitos
Si hay dudas dejalo: siempre puedes añadir pero no quitar.
La implementación no debe impactar en la API
Minimizar la accesibilidad a todo
Hacer las clases y miembros tan privados como sea posible
Las...