El documento detalla las herramientas y prácticas para la gobernanza de API, enfatizando la importancia de la transformación digital y el crecimiento del ecosistema de APIs. Incluye temáticas como seguridad, testing, y documentación, además de un enfoque en metodologías ágiles y herramientas de desarrollo. También presenta un perfil del autor y su experiencia en el ámbito de APIs y big data.

1. 24
meetups
900
api addicts
18.000
visualization
s
10K
3K 4K
Síguenos en @apiaddicts
Patrocinador:

2. /marcoantonio.sanz@apiaddicts.org
{ “name”:”Marco Antonio Sanz”,
“positions”: [
“CEO at CloudAppi” , “CEO at LeadGods”,
“Api Envangelist at ApiAddicts”, “Teacher at ufv”
] }
¿Quién soy yo?
@MarAntonio82

3. ❏ Apis como modelos de negocio
❏ Apis y el mundo Big Data
❏ Define una Api
❏ RAML
❏ Desarrolla tu primera Api en node.js
❏ Transformación digital en empresa
❏ Descubre el mundo Big Data
❏ Descubre el mundo Cloud
❏ Gobierno de apis
❏ Seguridad en las apis desde un punto de vista developer
❏ Api Managers
❏ MADA (Metodología ágil de desarrollo de apis)
MIS CHARLAS

4. Introducción
La transformación
digital ha impulsado
el ecosistema de Apis

5. Introducción
IoT ha multiplicado
exponencialmente las
Apis

6. Introducción
Herramientas especializadas dentro de la empresa
PROCESOS ERP
CRM RRHH
ECOMMERCE
MARKETING
SOPORTE

7. Introduction
¿Cómo funciona la comunicación entre ellas?

8. Introduction
Si la información la queremos compartir con terceros, la cosa se complica...

9. API Governance
➢ Definir recursos
➢ Política de versionado
➢ Políticas de seguridad
➢ Estándar de definición de apis
➢ Estándar de desarrollo de apis
➢ Documentación
➢ Monitorización
➢ Testing
➢ Billing
➢ Environment
Consideraciones generales

10. API Governance
Definimos recursos y atributos dentro de la
organización:
User
data:
{“name”:”Manolo”,”edad”:”12”}
Definiendo recursos

11. API Governance
Versionado
➢ Url
GET XXX/ejemplo/v1.0/users/
➢ Header
Accept: application/vnd.company.myapp-v3+json
Content-Type:
application/vnd.company.myapp-v3+json
➢ ¿Cuando se cambia de versión?
➢ ¿cuando se rompe la compatibilidad hacia atrás?

12. API Governance
➢ Api Manager?
➢ Authentication 2 / 3
○ 2 => aplicaciones
○ 3 => usuarios finales
➢ ¿Sistema de autenticación propietario o
utilizamos un estándar?
➢ Seguridad, ¿qué controlamos?
○ scopes
○ Resources and methods
Seguridad

13. ➢ Restful??
➢ Código de error de HTTP
➢ Formato de parámetros de entrada
➢ Parámetros especiales
➢ Formato de entrada / salida
➢ Verbos HTTP
➢ Paginación
➢ Niveles dentro de la URL
➢ Hypermedia
➢ ¿Granularidad?
Definiendo un estándar
API Governance

14. API Governance
➢ frameworks?
➢ Spring data rest / hateoas (java)
➢ restify / express (node.js)
➢ SDK: ¿Para qué lenguajes? Filosofía de SDK
➢ ¿Utilizamos un generador automático?
Estandarizando el desarrollo
http://www.slideshare.net/MarcoAntonioSanzMoli/taller-desarrollo-de-apis

15. API Governance
➢ Formato de documentación
○ Doc
○ HTML
○ RAML / Swagger
➢ ¿Dónde se deja la documentación?
¿Versionado? ¿Quién es el responsable de
tener la documentación actualizada?
Documentación

16. API Governance
➢ Estadísticas de uso
○ Number of requests per app
○ Number of requests per user (if it’s
possible)
○ Number of requests per resource
Number of requests per developer
○ Number of requests per http code
response
➢ Alertas
Monitorización

17. API Governance
➢ Tests integrados
○ ¿Desarrollas tus propios tests?
○ ¿Usas herramientas externas?
➢ ¿Automatizamos la ejecución?
○ Jenkins / jmeter / soapui / postman
➢ ¿Qué puedo probar?
○ Data
○ Http code response
Testing

18. API Governance
➢ Métodos de pago
○ Los Api Managers pueden ayudarme
➢ Modelo de billing
○ Requests
○ Services
○ Data (Scopes?)
➢ ¿Pagamos al developer por usar nuestras apis?
Billing

19. API Governance
➢ Pre-production
○ ¿Datos reales?
○ ¿Generamos datos de prueba?
➢ Producción
○ Nivel de soporte
➢ ¿Sandbox?
Environments

20. API Governance
➢ Pasos
○ Definición
➢ ¿fake?
➢ Desarrollo
➢ Testing / validación
➢ implementación
➢ Obsolescencia
Metodología

21. API Governance
➢ Crear y administrar las apis
➢ Obtener las credenciales de acceso
➢ Herramientas de testeo de apis
➢ Documentación / ejemplos / SDKs
➢ Monitorización
➢ Payment
➢ Estadísticas
Developer center
Aplicación para desarrolladores. Funcionalidades principales:

22. ¿Alguna pregunta?

23. Email:
➢ contacta@apiaddicts.org
Web:
➢ www.apiaddicts.org
➢ http://Apiaddicts.leadgods.com
Follow us:
Linkedin:
➢ https://www.linkedin.com/company/apiaddicts
Twitter: @apiaddicts
Facebook:
➢ https://www.facebook.com/pages/APIAddicts
Meetup:
➢ http://www.meetup.com/es-ES/ApiAddicts
Contact