DZone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
Refcards Trend Reports Events Over 2 million developers have joined DZone. Join Today! Thanks for visiting DZone today,
Edit Profile Manage Email Subscriptions Moderation Admin Console How to Post to DZone Article Submission Guidelines
View Profile
Sign Out
Refcards
Trend Reports
Events
Zones
Culture and Methodologies Agile Career Development Methodologies Team Management
Data Engineering AI/ML Big Data Data Databases IoT
Software Design and Architecture Cloud Architecture Containers Integration Microservices Performance Security
Coding Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones AWS Cloud
by AWS Developer Relations
Culture and Methodologies
Agile Career Development Methodologies Team Management
Data Engineering
AI/ML Big Data Data Databases IoT
Software Design and Architecture
Cloud Architecture Containers Integration Microservices Performance Security
Coding
Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance
Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones
AWS Cloud
by AWS Developer Relations
The Latest "Software Integration: The Intersection of APIs, Microservices, and Cloud-Based Systems" Trend Report
Get the report
  1. DZone
  2. Software Design and Architecture
  3. Integration
  4. Internal vs. External APIs: Does It Matter?

Internal vs. External APIs: Does It Matter?

Platforms that provide a unified approach to rolling out internal and/or external APIs can facilitate enterprises willing to develop an ecosystem around their APIs.

Mayur Shah user avatar by
Mayur Shah
·
Jan. 28, 17 · Opinion
Like (1)
Save
Tweet
Share
4.88K Views

Join the DZone community and get the full member experience.

Join For Free

For years, APIs and services have been around in enterprise computing. In the good old middleware days, service-oriented architecture came to existence and services were exposed using SOAP web service APIs. These APIs were mainly used to integrate applications to legacy systems and to one another.

With the advent of cloud and mobile and the need for massive internal and external adoption of services, REST-based APIs have replaced SOAP web services. REST APIs are HTTP-based, lighter, and easier to understand and integrate and therefore have become the defacto standard for creating enterprise APIs. Enterprise APIs can be internal APIs (i.e., APIs within or across LoB) and as well as for external APIs (i.e., APIs for partners or third-party developers).

In the past few years, enterprises learned from web-scale consumer APIs and realized that in order to create an ecosystem of applications around your API, there is more than just creating an API and expecting consumers to use them, be it internal or external.

Enter API Management

API management is the ability to document, publish, share, control, consume, and monitor the consumption of APIs. All of this is done in a fashion that allows for easy publishing and onboarding of developers using APIs.

So, the question is, if an enterprise is looking to publish internal and/or external APIs, is there a difference in managing them? The majority of enterprises consume more internal APIs than external ones. API management is essential for both internal as well as external APIs as long as there is a need for:

  • Providing an easy means to manage the lifecycle of APIs (create, publish, version, and retire).

  • Secured access for protecting sensitive data that is being exposed.

  • Differentiated access while allowing the consumption of APIs among stakeholders.

  • Easier on-boarding of applications and developers that consume the APIs.

  • Monitoring of real-time access and usage trends of APIs and take actions as required by the business.

So, how do you begin with API management? What we see is, depending on the maturity of the enterprise, the journey of API adoption can vary. Some enterprises with no APIs will start with internal APIs, get the ball rolling, work closely with internal stakeholders to fine tune the APIs, and then roll it out for external consumption. On the other hand, mature enterprises may start directly with external adoption. Some may just roll out internal APIs depending on the business need. Let’s take a look at differences in the requirements when it comes to publishing and consuming APIs.

Platforms that provide a unified approach to rolling out internal and/or external APIs can better facilitate enterprises willing to develop an ecosystem around their APIs. 

Web Service API mobile app Service-oriented architecture Adoption dev consumer SOAP Integration Web Protocols

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • Building a REST API With AWS Gateway and Python
  • Integrate AWS Secrets Manager in Spring Boot Application
  • Tackling the Top 5 Kubernetes Debugging Challenges
  • Cloud Performance Engineering

Comments

Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends: