Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
20
meetups
716
api addicts
16.000
visualization
s
9K
3K 2K
/marcoantonio.sanz@apiaddicts.org
{ “name”:”Marco Antonio Sanz”,
“positions”: [
“CEO at CloudAppi” , “CEO at LeadGods”,
“A...
Introduction
The vertical applications have the front end and the back end in the same
location. The front end speaks with...
Introduction
In company there can be a lot of applications deployed into the
organization. You can have applications for h...
Introduction
Sometimes it uses files, the other times it uses apis, soap… this is a not
efficient!!!
How the communication...
Introduction
And, all is more complicated if you expose information to other
organizations
API Governance
➢ Define resources
➢ Versioning policy
➢ Security policy
➢ Define the standard to define the apis
➢ Define ...
API Governance
Define objects and their attributes into
organization:
User
data:
{“name”:”Manolo”,”edad”:”12”}
Define the ...
API Governance
Versioning
➢ Url versioning
GET XXX/ejemplo/v1.0/users/
➢ Header versioning
Accept: application/vnd.company...
API Governance
➢ Api Manager?
➢ Authentication 2 / 3
○ 2 => applications
○ 3 => final users
➢ do you implemented a persona...
➢ Restful?? level of achievement?
➢ HTTP error codes
➢ Format of entry parameters
➢ Special entry parameters
➢ Input/Outpu...
API Governance
➢ frameworks?
➢ Spring data rest / hateoas (java)
➢ restify / express (node.js)
➢ SDK: For what languages? ...
API Governance
➢ Documentation format
○ Doc
○ HTML
○ RAML / Swagger
➢ Where do we leave the documentation for
developers? ...
API Governance
➢ Statistics of use
○ Number of requests per app
○ Number of requests per user (if it’s
possible)
○ Number ...
API Governance
➢ Integrations tests.
○ ¿Do you develop your integration tests?
○ ¿Do you use external tools to implement
t...
API Governance
➢ Payment methods
○ Api Managers can help me
➢ Billing model
○ Requests
○ Services
○ Data (Scopes?)
➢ Can y...
API Governance
➢ Pre-production
○ Real data?
○ Generated data?
➢ Production
○ Support
➢ Sandbox?
Environments
http://www.s...
API Governance
➢ Steps
○ Definition
➢ Fake?
➢ Develope
➢ Testing / validation
➢ Implementation
➢ Obsolescence
Methodology
...
API Governance
➢ Create and manage consumer apis
➢ Get api access key
➢ Testing api tools
➢ Documentation / samples / SDKs...
Any questions?
Email:
➢ info@apiaddicts.org
Web:
➢ www.apiaddicts.org
➢ http://Apiaddicts.leadgods.com
Follow us:
Linkedin:
➢ https://www...
Upcoming SlideShare
Loading in …5
×

1

Share

Download to read offline

Api governance (APIdays Mediterránea)

Download to read offline

All you need to develop an api governance, definition, development, security, environments, billing

Related Books

Free with a 30 day trial from Scribd

See all

Api governance (APIdays Mediterránea)

  1. 1. 20 meetups 716 api addicts 16.000 visualization s 9K 3K 2K
  2. 2. /marcoantonio.sanz@apiaddicts.org { “name”:”Marco Antonio Sanz”, “positions”: [ “CEO at CloudAppi” , “CEO at LeadGods”, “Api Envangelist at ApiAddicts”, “Teacher at ufv” ] } Who am i? @MarAntonio82
  3. 3. 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?
  4. 4. 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 ?
  5. 5. Introduction Sometimes it uses files, the other times it uses apis, soap… this is a not efficient!!! How the communication between us work?
  6. 6. Introduction And, all is more complicated if you expose information to other organizations
  7. 7. 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
  8. 8. API Governance Define objects and their attributes into organization: User data: {“name”:”Manolo”,”edad”:”12”} Define the resources
  9. 9. API Governance Versioning ➢ Url versioning GET XXX/ejemplo/v1.0/users/ ➢ Header versioning Accept: 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?
  10. 10. 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
  11. 11. ➢ 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
  12. 12. 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
  13. 13. 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
  14. 14. 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
  15. 15. 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
  16. 16. 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
  17. 17. API Governance ➢ Pre-production ○ Real data? ○ Generated data? ➢ Production ○ Support ➢ Sandbox? Environments http://www.slideshare.net/MarcoAntonioSanzMoli/las-apis-como-modelo-de-negocio
  18. 18. 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
  19. 19. API Governance ➢ Create and manage consumer apis ➢ Get api access key ➢ Testing api tools ➢ Documentation / samples / SDKs ➢ Monitoring ➢ Payment ➢ Statistics Developer center There is an application for developers. Some features
  20. 20. Any questions?
  21. 21. Email: ➢ info@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
  • mcrosasb

    Nov. 23, 2016

All you need to develop an api governance, definition, development, security, environments, billing

Views

Total views

1,864

On Slideshare

0

From embeds

0

Number of embeds

19

Actions

Downloads

114

Shares

0

Comments

0

Likes

1

×