api governance (apidays mediterránea)
TRANSCRIPT
![Page 1: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/1.jpg)
20meetups
716api addicts
16.000
visualizations
9K3K 2K
![Page 2: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/2.jpg)
{ “name”:”Marco Antonio Sanz”,
“positions”: [
“CEO at CloudAppi” , “CEO at LeadGods”,
“Api Envangelist at ApiAddicts”, “Teacher at ufv”
] }
Who am i?
@MarAntonio82
![Page 3: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/3.jpg)
Introduction
The vertical applications have the front end and the back end in the same location. The front end speaks with the back end using objects.
What vertical application means?
![Page 4: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/4.jpg)
Introduction
In company there can be a lot of applications deployed into the organization. You can have applications for human resources, sellers, buyers...
How many applications can be in the company ?
![Page 5: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/5.jpg)
Introduction
Sometimes it uses files, the other times it uses apis, soap… this is a not efficient!!!
How the communication between us work?
![Page 6: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/6.jpg)
Introduction
And, all is more complicated if you expose information to other organizations
![Page 7: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/7.jpg)
API Governance
➢ Define resources➢ Versioning policy➢ Security policy➢ Define the standard to define the apis➢ Define the standard to deploy the apis➢ Documentation➢ Monitorization➢ Testing➢ Billing➢ Environment
General considerations
![Page 8: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/8.jpg)
API Governance
Define objects and their attributes into organization:Userdata: {“name”:”Manolo”,”edad”:”12”}
Define the resources
![Page 9: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/9.jpg)
API GovernanceVersioning➢ Url versioning
GET XXX/ejemplo/v1.0/users/
➢ Header versioningAccept: application/vnd.company.myapp-v3+json Content-Type: application/vnd.company.myapp-v3+json
➢ When the version of api should be changed?
➢ How to deal with breaking backwards compatibility?
![Page 10: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/10.jpg)
API Governance
➢ Api Manager? ➢ Authentication 2 / 3
○ 2 => applications○ 3 => final users
➢ do you implemented a personal system authentication or do you use a standard?
➢ Security into the apis. ¿do you control information?○ scopes○ Resources and methods
Security
http://www.slideshare.net/MarcoAntonioSanzMoli/seguridad-en-las-apis
![Page 11: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/11.jpg)
➢ Restful?? level of achievement?➢ HTTP error codes➢ Format of entry parameters➢ Special entry parameters➢ Input/Output format➢ HTTP Verbs➢ Paging➢ URL levels➢ Hypermedia➢ Granularity of services
Standard definition
http://www.slideshare.net/MarcoAntonioSanzMoli/taller-definicin-de-apis
API Governance
![Page 12: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/12.jpg)
API Governance
➢ frameworks? ➢ Spring data rest / hateoas (java)➢ restify / express (node.js)➢ SDK: For what languages? Development
philosophy of SDK➢ Should we start some code generator?
Standard development
http://www.slideshare.net/MarcoAntonioSanzMoli/taller-desarrollo-de-apis
![Page 13: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/13.jpg)
API Governance
➢ Documentation format○ Doc○ HTML○ RAML / Swagger
➢ Where do we leave the documentation for developers? Present version / previous versions - who manages the update documentation?
Documentation
![Page 14: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/14.jpg)
API Governance
➢ Statistics of use○ 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
➢ Alerts
Monitoring
![Page 15: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/15.jpg)
API Governance
➢ Integrations tests.○ ¿Do you develop your integration tests?○ ¿Do you use external tools to implement
tests?➢ ¿Do you go to automatize tests?
○ Jenkins / jmeter / soapui / postman➢ ¿what can i test?
○ Data○ Http code response
Testing
![Page 16: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/16.jpg)
API Governance
➢ Payment methods○ Api Managers can help me
➢ Billing model○ Requests○ Services○ Data (Scopes?)
➢ Can you afford to pay a developer for using your
Billing
http://www.slideshare.net/MarcoAntonioSanzMoli/las-apis-como-modelo-de-negocio
![Page 17: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/17.jpg)
API Governance
➢ Pre-production○ Real data?○ Generated data?
➢ Production○ Support
➢ Sandbox?
Environments
http://www.slideshare.net/MarcoAntonioSanzMoli/las-apis-como-modelo-de-negocio
![Page 18: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/18.jpg)
API Governance
➢ Steps○ Definition
➢ Fake?➢ Develope➢ Testing / validation➢ Implementation➢ Obsolescence
Methodology
http://www.slideshare.net/MarcoAntonioSanzMoli/mada-metodologa-gil-de-desarrollo-de-ap-is-37095756
![Page 19: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/19.jpg)
API Governance
➢ Create and manage consumer apis ➢ Get api access key➢ Testing api tools➢ Documentation / samples / SDKs➢ Monitoring➢ Payment➢ Statistics
Developer centerThere is an application for developers. Some features
![Page 20: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/20.jpg)
Any questions?
![Page 21: Api governance (APIdays Mediterránea)](https://reader038.vdocuments.site/reader038/viewer/2022102615/58714d931a28ab55588b71e5/html5/thumbnails/21.jpg)
Email:
Web:
➢ www.apiaddicts.org
➢ http://Apiaddicts.leadgods.com
Follow us: Linkedin: ➢ https://www.linkedin.com/company/apiaddic
ts
Twitter: @apiaddicts
Facebook:
➢ https://www.facebook.com/pages/APIAddicts
Meetup:
➢ http://www.meetup.com/es-ES/ApiAddicts
Contact