Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
Powering Internal
API Communities
Ian Goldsmith
Sachin Agarwal
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
API and SOA Resources
• Resource Center
– http://resource.soa.com/
• Webinar Recording
– http://resource.soa.com/resource/webinars
• Follow us on:
www.facebook.com/soasoftware
www.linkedin.com/company/soasoftware
@soasoftwareinc
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
YouTube.com/SOASoftware/
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
slideshare.net/SOA_Software/
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
What is an Internal API Catalog?
The application of API technologies inside the enterprise
• Easy to consume
• Well documented
(human-readable)
• Self-service
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
Why do Enterprises need API Communities?
• Support Digital Transformation Initiatives
• Reuse of in-house developed assets
• Controlled use of cloud services
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
Promise of SOA
• Built using UDDI Registries, WSDL and
SOAP
• Addressed service definition and control
• However, developer adoption remained a
challenge
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
Promise of APIs
• Documentation
• Self-Service Access
• Greater Adoption
• However…APIs lack control
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
Making Internal API Communities Work
• Make sure you publish the right APIs
– Deliver real value
– Focus on API Design
– Reusable
• Make it easy to consume an API
– Searchable catalog
– Well documented
– Self Provisioned
• Make sure the APIs are:
– Reliable
– High performance
– Secure
Fundamentally, this is Governance
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
Publishing the right APIs
• Increase responsiveness to business
• Improve business/IT alignment
• Manage API DevOps
• Automate API and App Provisioning
• Visualize Asset Relationships
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
Ensure Reliability and Security
• Authenticate and Authorize, integrate with
existing Identity & Access Mgmt. systems
• Federate API access with Business
Partners - OAuth
• Risk and Compliance factors with
publishing APIs
• Routing and load-balancing for
performance and high-availability
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
Developer Engagement
• Search Indexing
• Documentation
• Groups
• Built-in Testing
• Social Platform
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
API Platform
• Measure the impact of
your programsAnalytics
• Build your developer
and partner ecosystem
Developer
Engagement
• Secure and protect
your systemsGateway Services
• Simplify and speed up
development
Service
Integration
• Build the right services
& APIs the right way
Lifecycle
Management
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
The role of an API Gateway
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
What are the Common Pitfalls?
• Platform lock-in
• Protocol limitations
• Lack of control (lifecycle)
• Not integrating enterprise infrastructure
– IDAM
– Monitoring (SIEM, SNMP)
– SCM
– Databases
Copyright © 2001-2014 SOA Software, Inc. All Rights Reserved.
API and SOA Resources
• Resource Center
– http://resource.soa.com/
• Webinar Recording
– http://resource.soa.com/resource/webinars
• Follow us on:
www.facebook.com/soasoftware
www.linkedin.com/company/soasoftware
@soasoftwareinc

Powering Internal API Communities

  • 1.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. Powering Internal API Communities Ian Goldsmith Sachin Agarwal
  • 2.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. API and SOA Resources • Resource Center – http://resource.soa.com/ • Webinar Recording – http://resource.soa.com/resource/webinars • Follow us on: www.facebook.com/soasoftware www.linkedin.com/company/soasoftware @soasoftwareinc
  • 3.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. YouTube.com/SOASoftware/
  • 4.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. slideshare.net/SOA_Software/
  • 5.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. What is an Internal API Catalog? The application of API technologies inside the enterprise • Easy to consume • Well documented (human-readable) • Self-service
  • 6.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. Why do Enterprises need API Communities? • Support Digital Transformation Initiatives • Reuse of in-house developed assets • Controlled use of cloud services
  • 7.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. Promise of SOA • Built using UDDI Registries, WSDL and SOAP • Addressed service definition and control • However, developer adoption remained a challenge
  • 8.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. Promise of APIs • Documentation • Self-Service Access • Greater Adoption • However…APIs lack control
  • 9.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. Making Internal API Communities Work • Make sure you publish the right APIs – Deliver real value – Focus on API Design – Reusable • Make it easy to consume an API – Searchable catalog – Well documented – Self Provisioned • Make sure the APIs are: – Reliable – High performance – Secure Fundamentally, this is Governance
  • 10.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. Publishing the right APIs • Increase responsiveness to business • Improve business/IT alignment • Manage API DevOps • Automate API and App Provisioning • Visualize Asset Relationships
  • 11.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. Ensure Reliability and Security • Authenticate and Authorize, integrate with existing Identity & Access Mgmt. systems • Federate API access with Business Partners - OAuth • Risk and Compliance factors with publishing APIs • Routing and load-balancing for performance and high-availability
  • 12.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. Developer Engagement • Search Indexing • Documentation • Groups • Built-in Testing • Social Platform
  • 13.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. API Platform • Measure the impact of your programsAnalytics • Build your developer and partner ecosystem Developer Engagement • Secure and protect your systemsGateway Services • Simplify and speed up development Service Integration • Build the right services & APIs the right way Lifecycle Management
  • 14.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. The role of an API Gateway
  • 15.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. What are the Common Pitfalls? • Platform lock-in • Protocol limitations • Lack of control (lifecycle) • Not integrating enterprise infrastructure – IDAM – Monitoring (SIEM, SNMP) – SCM – Databases
  • 16.
    Copyright © 2001-2014SOA Software, Inc. All Rights Reserved. API and SOA Resources • Resource Center – http://resource.soa.com/ • Webinar Recording – http://resource.soa.com/resource/webinars • Follow us on: www.facebook.com/soasoftware www.linkedin.com/company/soasoftware @soasoftwareinc