Curso Gobierno de APIs en Madrid, Barcelona y Online

Los procedimientos y prácticas que se pueden realizar para alcanzar un buen gobierno de API´s se agrupan en ocho bloques fundamentales:

• API bien definida. La organización debe contar con un estándar de definición, es decir, se debe mostrar de manera explícita que está permitido y que no está no permitido a la hora de definir una API dentro de la organización. Por otro lado, se debe identificar las pautas para definir de manera homogénea cada uno de sus componentes, como los códigos de estado o las estructuras de respuesta.
• API seguridad. Cuando se define una API también se fijan los criterios de seguridad que deberán cumplir. Así, se marcan una serie de estándares de seguridad (OWASP), como gozar de cierta capa de seguridad: rate limiting, antiataque, etc. En este sentido, algunos criterios deben ser comunes en todas las API´s de la organización y otros específicos de cada API.
• API bien probada. La implementación de una API debe contar con cierto nivel de calidad. Esto lo podemos comprobar da través de pruebas manuales, análisis de código, test unitarios o test de integración o e2e.
• API homogéneas a nivel de organización. Tenemos un problema cuando los reursos de una API tienen cualidades distintas en otra API. Por ello, es importante asumir definiciones estándar para recursos comunes que sean utilizados en las definiciones de múltiples API´s, ya que permite simplificar su definición, reutilizando recursos y smplificando el consumo de las mismas.
• API bien gobernada. Una API debe contener distintos entornos, cada uno de ellos aportando un valor distinto en la cadena de desarrollo de la API: desde el entorno de desarrollo e integración de funcionalidades hasta el entorno de staging o el entorno de producción.
• Procesos y roles. La gestión del ciclo de vida de una API es uno de los procesos más importantes. Por ello, es importante definir la estrategia a seguir respecto a nuevas versiones, el tiempo devida de la API o las notificaciones de actualización de la misma, así como definir los roles: API Owner, API Developer, API Tester, DevOps y Operations Team.
• Monitorización. Es una de las partes fundamentales durante el proceso de producción de una API. Este proceso incluye componentes como endpoints de status, gestión de logs, log server y alarmas.
• Catalogación. A medida que aumenta el número de API´s en una organización es necesario contar con herramientas de control, como API Portal, que nos permitan tenerlas definidas y catalogadas.