API Review Shop
menu

API

Review

APIs power our desktop, web, mobile, and device applications. APIs are powering all of the applications, as well system to system integrations we depend on to make business happen each day. Each and every business today are using APIs, but what makes the difference is how they are taking control of the production and consumption of APIs across operations in repeatable ways.
Your company is producing APIs today without the consistency you need across teams and lines of business. This often is the result of legacy practices building up, a lack of API design skills across teams, or a number of other factors. The inconsistencies across your APIs, and lack of alignment with common API practices are costing you money, and introducing unnecessary friction across your business operations.
Our services are simple. We provide impartial external design reviews for your APIs. We aren't concerned with the same business and politics as you are, and can help be that extra set of eyes you need bring the consistency you need. We aren't the domain experts you are, but we know APIs, and can help bring the expertise you need to shift your API operations to the next level.

The Business

As part of our review, we consider the business value being provided by your API and think about what the overall narrative is for your APIs, helping reduce the time it takes for your API consumers to get up to speed on what your API does.

It is common for API producers to be too close to problem as well as the solution and they often overlook what is needed to get consumers what they need when it comes to onboarding with an API, and begin using in applications.

Sometimes a fresh pair of trained eyes can help see what is needed to improve the usability of your APIs.

The name, description, tags, and other metadata exist for your API.

Help you consider who will be using your API and what they will need.

Thinking through what people will be doing when integrating with your API.

Considering how you will organize and discover your APIs using tags.

We evaluate how you are managing change across your all of your APIs.

Ensuring your API tells a story and offers up a compelling narrative

The Technical

We enjoy looking at the technical details of your APIs and understand how they size up against the competition, evaluating the path, parameters, request bodies, responses, and other elements.

Provide RESTful guidance regarding naming and structure of paths.

Offer advice regarding how to use your nouns and verbs wisely.

Assist in making sure each API operation is as intuitive as possible.

Consider your path, query, and header parameters in our evaluation.

Ensure that you are standardized across all of your API responses.

Help you standardize the schema you are using in requests and responses.

API Reviewers

We have the API design talent that you have been looking for--available on demand, as you need it.


You don't have time to get all of your teams up to speed when it comes to API design, and you can lean on our team as your core source of design talent, or as an overflow and second pair of eyes.


We aren't as close to your business as you are, and better able to provide unbiased, outside, and expert critique of the design of your APIs, providing you what need to standardize your APIs.

Nick

API Designer

Nick is all about simple REST APIs, and the impact it can have they have when done well.

Jerry

API Architect

Jerry is our old XML guy, who we have converted to the modern JSON way of doing things.

Jon

API Designer

Jon is looking for the story in your API, making sure it is as intuitive as it possibly can.

Criteria

These are the things we are looking for as we conduct our design reviews, ensuring your APIs reflect what developers are needing when it comes to onboarding, integrating, and putting your APIs to work.

  • Info
  • Paths
  • Operations
  • Request Bodies
  • Parameters
  • Responses
  • Schema

Example Reviews

These are a handful of example reviews we have done on public APIs, helping demonstrate what we are looking at when we review any API.

  • Twilio
  • Stripe

Get Your Review

Getting a review for your API is simple, just tell us a little about you, and submit the form with your OpenAPI--here is what you can expect.
  • You Submit Form On This Website
  • We Receive An Email From You
  • We Get You A Quote For the Review
  • You Accept the Review Quote From Us
  • We Conduct the Review of Your API
  • We Send An Invoice To You via Email
  • You Pay The Invoice We Sent to You
  • We Publish YAML Report to Private GitHub Repository
  • We Publish Markdown Report to Private GitHub Repository
  • We Add You to the Private GitHub Repository
  • You Request the Review of More of Your APIs
  • Your Private Repo Acts As Private Catalog of Reviews
  • We Help You Standardize Across All of Your APIs
We are low-tech here, in an effort to contrast the Artificial Intelligence (AI) groundswell, focusing on doing one thing well, and helping standardize your API operations today.