On charge of: Agustina Aldasoro y Lucas Simonelli. Medallia
Thursday, 14 October 14hs.
Aula Mayor UNRC
Abstract
En Medallia, hoy en día, existen más de 200 REST APIs funcionando. Para que éstas puedan ser utilizadas con éxito, necesitan tener un contrato claro, y garantizar que su implementación lo cumpla. Por lo tanto el proceso de desarrollo de APIs tiene dos componentes fundamentales, una sintáctica y la otra semántica:
Al dar forma a una API, se define primero su contrato, usando un subconjunto del Open API spec, un lenguaje de especificación de APIs basado en YAML. A continuación, nuestras herramientas de desarrollo generan las interfaces necesarias para implementar esta funcionalidad en base al contrato definido. De esta forma, se puede garantizar que la implementación hace lo que la especificación define, y así se garantiza la consistencia sintáctica.
Siendo el ecosistema de APIs de Medallia tan diverso, una condición importante es que todas las APIs deben ser semánticamente consistentes entre sí. Esto es, queremos que cada API de Medallia respete ciertos estándares. Para esto, existe el API Spec de Medallia, que es un conjunto de reglas semánticas basado en una especialización de Open API Spec 2.0 que toda API en Medallia debe seguir.
Esto último plantea un problema: ¿cómo se puede asegurar que todas las APIs cumplan dichas reglas si éstas últimas muchas veces son sólo explícitas al ver la API en acción?
En esta charla vamos a presentar el testing harness que desarrollamos para responder ese interrogante, y cómo éste se integra de forma orgánica con el ecosistema de APIs existente.