Develop APIs That Work Properly for the Organization

Leverage APIs to connect your systems in today’s web-based world.


This content requires an active subscription.

Access this content by logging in with your Info-Tech Research Group membership or contacting one of our representatives for assistance.

Speak With A Representative Sign In
or Call: 1-888-670-8889 (US) or 1-844-618-3192 (CAN)

Your Challenge

  • CIOs have trouble integrating new technologies (e.g. mobile, cloud solutions) with legacy applications, and lack standards for using APIs across the organization.
  • Organizations produce APIs that are error-prone, not consistently configured, and not maintained effectively.
  • Organizations are looking for ways to increase application quality and code reusability to improve development throughput using web APIs.
  • Organizations are looking for opportunities to create an application ecosystem which can expose internal services across the organization and/or to external third parties and business partners.

Our Advice

Critical Insight

  • Organizations are looking to go beyond current development practices to provide scalable and reusable web services.
  • Web API development is a tactical competency that is important to enabling speed of development, quality of applications, reusability, innovation, and business alignment.
  • Design your web API as a product that promotes speed of development and service reuse.
  • Optimize the design, development, testing, and monitoring of your APIs incrementally and iteratively to cover all use cases in the long term. 

Impact and Result

  • Create a repeatable process to improve the quality, reusability, and governance of your web APIs.
  • Define the purpose of your API and the common uses cases that it will service.
  • Understand what development techniques are required to develop an effective web API based on Info-Tech’s web API framework.
  • Continuously reiterate your web API to demonstrate to business stakeholders the value your web API provides.


  • Ken Toole, Adobe
  • Alan Page, Principal Software Engineer, Microsoft
  • Ed Anuff, VP, Product Strategy, Apigee
  • John Musser, Founder and CEO, API Science

Want to Participate in Our Research?

  • Analyst Interviews: Share your best practices, opinions, tools or templates with your peers.
  • Webinars: Interactive session to keep us focused on topics you want to tackle.
  • Upcoming Workshops: Accelerate your project with an onsite, expert analyst to facilitate a workshop for you. Contact us for more details.

Become a Participant

Get the Complete Storyboard

See how all the steps you need to take come together, with tools and advice to help with each task on your list.

Download Now

Get to Action

Start here – read the Executive Brief

Read our concise Executive Brief to find out why you should develop APIs, review Info-Tech’s methodology, and understand the four ways we can support you in completing this project.

  1. Examine the opportunities web APIs can enable

    Assess the opportunities of web APIs.

  2. Design and develop a web API

    Design and develop web APIs that support business processes and enable reusability.

  3. Test the web API

    Accommodate web API testing best practices in application test plans.

  4. Monitor and continuously optimize the web API

    Monitor the usage and value of web APIs and plan for future optimizations and maintenance.

Guided Implementation icon Guided Implementation

This guided implementation is a five call advisory process.

    Guided Implementation #1 - Examine the opportunities web APIs can enable

  • Call #1: Determine what value your web APIs offer.

  • Guided Implementation #2 - Design and develop a web API

  • Call #1: Develop a process for designing your web APIs to determine your endpoints.

  • Call #2: Determine how to develop your web APIs with considerations made for how it will be consumed.

  • Guided Implementation #3 - Test the web API

  • Call #1: Develop a process for testing your web APIs.

  • Guided Implementation #4 - Monitor and continuously optimize the web API

  • Call #1: Develop a process for monitoring your web APIs for continuous optimization.

Onsite Workshop

Module 1: Examine the Opportunities Web APIs Can Enable

The Purpose

  • Gauge the importance of web APIs for achieving your organizational needs.
  • Understand how web APIs can be used to achieve below-the-line and above-the-line benefits.
  • Be aware of web API development pitfalls. 

Key Benefits Achieved

  • Understanding the revenue generation and process optimization opportunities web APIs can bring to your organization.
  • Knowledge of the current web API landscape. 

Activities: Outputs:
1.1 Examine the opportunities web APIs can enable.

Module 2: Design & Develop Your Web API

The Purpose

  • Establish a web API design and development process.
  • Design scalable web APIs around defined business process flows and rules.
  • Define the web service objects that the web APIs will expose. 

Key Benefits Achieved

  • Reusable web API designs.
  • Identification of data sets that will be available through web services.
  • Implement web API development best practices. 

Activities: Outputs:
2.1 Define high-level design details based on web API requirements.
  • High-level web API design.
2.2 Define your process workflows and business rules.
  • Business process flow.
2.3 Map the relationships among data tables through ERDs.
  • Entity relationship diagrams.
2.4 Define your data model by mapping the relationships among data tables through data flow diagrams.
  • Data flow diagrams.
2.5 Define your web service objects by effectively referencing your data model.
  • Identification of web service objects.

Module 3: Test Your Web API

The Purpose

  • Incorporate APIs into your existing testing practices.
  • Emphasize security testing with web APIs.
  • Learn of the web API testing and monitoring tool landscape.

Key Benefits Achieved

  • Creation of a web API test plan.

Activities: Outputs:
3.1 Create a test plan for your web API.
  • Web API Test Plan.

Module 4: Monitor and Continuously Optimize Your Web API

The Purpose

  • Plan for iterative development and maintenance of web APIs.
  • Manage web APIs for versioning and reuse.
  • Establish a governance structure to manage changes to web APIs. 

Key Benefits Achieved

  • Implement web API monitoring and maintenance best practices.
  • Establishment of a process to manage future development and maintenance of web APIs. 

Activities: Outputs:
4.1 Identify roles for your API development projects.
  • RACI table that accommodates API development.
4.2 Develop governance for web API development.
  • Web API operations governance structure.

Workshop Icon Book Your Workshop

Onsite Workshops offer an easy way to accelerate your project. If you are unable to do the project yourself, and a Guided Implementation isn’t enough, we offer low-cost onsite delivery of our Project Workshops. We take you through every phase of your project and ensure that you have a road map in place to complete your project successfully.

Book Now

Application Development Map


  • Missing comment
    Evan Leland | 09-28-2016

    I want the pop-up dialog: "Are you sure you've got all the pieces of the puzzle?" to go away. I HAVE all the pieces that i need right now. So I want the dialog to disappear, so that I can read the rest of the page.

    • 432c05244a845caaca3b276adb15a11e comment
      Info-Tech Research Group | 10-04-2016

      I apologize for the inconvenience. The box you are referring to shouldn’t be blocking the page, and it looks like a scroll bar has been added which hides the “X” to close the box. I’ve forwarded your comment to the web team who will address the issue.

Hide Details

Search Code: 78073
Published: July 13, 2015
Last Revised: July 13, 2015

GET HELP Contact Us
VL Methodology