Design iterations

If you think your job is now done, you’re wrong. What you’ve done is just one of possibly many iterations that you’ll go through. The goal of iterating is to improve your API design by enhancing and polishing it with the feedback that you receive from stakeholders on each iteration. However, it’s always good to be careful about the credibility and relevance of the feedback you receive. One thing to keep in mind is the level of expertise of the person giving you feedback. You can build a profile of each stakeholder where you identify their experience level, domain knowledge, and familiarity with API products similar to the one that you’re building. These factors will help you understand which stakeholders are credible so that you can give more importance to their feedback.

Another way to check for feedback credibility is to verify how a stakeholder tested your API product and compare their actions to their feedback. If the provided...