Skip to content

Commit

Permalink
Case study design and grammar improvements
Browse files Browse the repository at this point in the history
  • Loading branch information
255kb committed Jan 9, 2024
1 parent 3522367 commit b645e8c
Show file tree
Hide file tree
Showing 4 changed files with 20 additions and 24 deletions.
4 changes: 2 additions & 2 deletions components/article.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ const Article: FunctionComponent<{
return (
<Fragment>
{props.articleData.header && (
<section className='article-header pt-7 py-5'>
<section className='article-header text-gray-300 pt-7 py-5'>
<div className='container'>
<div className='row d-flex align-items-center'>
<div className='text-center col-12 col-lg-4'>
Expand All @@ -23,7 +23,7 @@ const Article: FunctionComponent<{
<div className='col-12 col-lg-8 text-center'>
<div className='row pt-5 pt-lg-0'>
<p className='col-12 mb-0 d-flex flex-column'>
<span className='text-uppercase text-white'>Overview</span>
<span className='text-uppercase text-white'>About</span>
<span className='mt-n1'>
{props.articleData.header.overview}
</span>
Expand Down
24 changes: 12 additions & 12 deletions content/case-studies/impala-api-ux-user-research.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,44 +17,44 @@ header:
order: 10
---

Building an API requires a lot of work. But designing an API that feels intuitive to use and is effortless to integrate for your developers probably represents a greater challenge. We all know that conducting user research is crucial when working on graphical interfaces, but did you know that API user research could help you nail API design? Impala understood it and successfully integrated user research in their API development workflow.
Building an API requires a lot of work, but designing an API that feels intuitive to use and is effortless to integrate for your developers probably represents a greater challenge. While we all know that conducting user research is crucial when working on graphical interfaces, did you know that API user research could help you nail API design? Impala understood this and successfully integrated user research into their API development workflow.

### Impala is conducting user research when designing their APIs

Impala is creating hotel booking APIs for the travel industry, and lets developers book hotel rooms through their API within minutes. To live up to their promise, they strive to create the best experience for their users. The first reason is because ease-of-use is one of the most important factors when choosing an API. The second is because APIs that are easy to reason about and with clear documentation translate in fewer integration mistakes and errors.
It results in a win-win situation, happy customers, quick integration time, and fewer support requests.
Impala is creating hotel booking APIs for the travel industry, allowing developers to book hotel rooms through their API within minutes. To live up to their promise, they strive to create the best experience for their users. The first reason is that ease of use is one of the most important factors when choosing an API. The second reason is that APIs that are easy to understand and come with clear documentation result in fewer integration mistakes and errors.

This approach leads to a win-win situation: happy customers, quick integration times, and fewer support requests.

> {"type": "##quotation##", "citation": "Public APIs require the same, if not more, research and validation than UI design before they are built and released.", "author": "Toby Urff", "authorRole": "CPO & Co-founder @ Impala", "pictureUrl": "case-studies/impala/toby-urff.jpg"}
Impala understands this fact better than any other company, and their API design process is well-proven. After writing extensive documentation and OpenAPI specifications for each new feature or endpoint, they invite a few outside developers for 45 minutes user research sessions. During these sessions, they ask the participants to perform several tasks in the new API. By getting this immediate feedback, they ensure that the feature will be easy to understand and integrate.
Impala understands this fact better than any other company, and their API design process is well-proven. After writing extensive documentation and OpenAPI specifications for each new feature or endpoint, they invite a few outside developers for 45-minute user research sessions. During these sessions, they ask the participants to perform several tasks in the new API. By obtaining this immediate feedback, they ensure that the feature will be easy to understand and integrate.

### Using Mockoon during API user research

Since Impala started doing these users research sessions during API development, they also mocked their APIs to provide the new endpoints to the participant without too much hassle. However, API mocking presents challenges, especially if you want the experience to be realistic and have limited time to set it up. And creating convincing mocks for short sessions of 45 minutes can be very time-consuming and sometimes a bit overkill. Impala found that available mocking tools on the market provide limited mocking possibilities and don't offer enough features that guarantee the realistic experience required by such focus groups.
Since Impala started conducting these user research sessions during API development, they also mocked their APIs to provide the new endpoints to the participants without too much hassle. However, API mocking presents challenges, especially if you want the experience to be realistic and have limited time to set it up. Creating convincing mocks for short sessions of 45 minutes can be very time-consuming and sometimes a bit overkill. Impala found that available mocking tools on the market provide limited mocking possibilities and don't offer enough features to guarantee the realistic experience required by such focus groups.

> {"type": "##quotation##", "citation": "Mockoon is the answer to just about every mocking need you might have.", "author": "Yasmin Desai", "authorRole": "Senior Product Manager @ Impala", "pictureUrl": "case-studies/impala/yasmin-desai.jpg"}
Mockoon offers a unique set of features like templating and rules that allow to set up great mocks in no time. Some of these advanced features help to create complex scenarios that closely mimic the behavior of APIs. It's also the kind of setup you wouldn't want to put in place by hand, especially when you need to do this every time you plan new focus groups.
Mockoon offers a unique set of features, such as templating and rules, that allow users to set up great mocks in no time. Some of these advanced features help create complex scenarios that closely mimic the behavior of APIs. It's the kind of setup you wouldn't want to implement manually, especially when you need to do this every time you plan new focus groups.

### Mockoon helps you build realistic mocks

Mockoon's advanced features allow Impala to quickly create realistic scenarios without the hassle of assembling multiple tools or libraries. They can easily set up endpoints returning dynamic and realistic content by [generating fake data](/tutorials/generate-mock-json-data/) and reacting to participants' entries. Simulating authentication or pagination mechanisms become a breeze thanks to the available [templating helpers](docs:templating/overview) and [responses rules](docs:route-responses/dynamic-rules) system.
Mockoon's advanced features enable Impala to quickly create realistic scenarios without the hassle of assembling multiple tools or libraries. They can easily set up endpoints that return dynamic and realistic content by [generating fake data](/tutorials/generate-mock-json-data/) and reacting to participants' entries. Simulating authentication or pagination mechanisms becomes a breeze thanks to the available [templating helpers](docs:templating/overview) and [response rules](docs:route-responses/dynamic-rules) system.

### Real time API behavior adjustment

One advantage of using Mockoon is the possibility to quickly adjust and modify the behavior of a running API mock. Thus, following participants' feedback, Impala can rapidly fine-tune the API parameters, rename confusing property names or update the endpoint responses. It can be done seamlessly from the interface without the need for redeploying or restarting the mock.
One advantage of using Mockoon is the ability to quickly adjust and modify the behavior of a running API mock. Thus, following participants' feedback, Impala can rapidly fine-tune the API parameters, rename confusing property names, or update the endpoint responses. This can be done seamlessly from the interface without the need for redeploying or restarting the mock.

### OpenAPI compatibility and partial mocking

Impala is creating their API documentation using the OpenAPI specification, with which Mockoon is compatible. By importing OpenAPI specification files in Mockoon, they can quickly create a skeleton for the mock. It allows Impala to retain their API design tool of choice while ensuring an excellent mocking experience.
Impala is creating their API documentation using the OpenAPI specification, which is compatible with Mockoon. By importing OpenAPI specification files into Mockoon, they can quickly create a skeleton for the mock. This allows Impala to retain their API design tool of choice while ensuring an excellent mocking experience.

Besides, Mockoon makes it easy to test new features that are part of larger workflows thanks to its [proxy mode](docs:server-configuration/proxy-mode). Impala can set up partial mocks covering the endpoints related to the new feature while forwarding the rest of the calls to their existing APIs.
Furthermore, Mockoon makes it easy to test new features that are part of larger workflows, thanks to its [proxy mode](docs:server-configuration/proxy-mode). Impala can set up partial mocks covering the endpoints related to the new feature while forwarding the rest of the calls to their existing APIs.

### Using Mockoon for user research is a no-brainer

> {"type": "##quotation##", "citation": "If you are building a public API as part of your product, try using Mockoon not just to mock an API for internal development, but for UX research. It's a really low-effort way to make sure developers building in your ecosystem have a great time doing so.", "author": "Toby Urff", "authorRole": "CPO & Co-founder @ Impala", "pictureUrl": "case-studies/impala/toby-urff.jpg"}
Impala's found that thanks to Mockoon's complete set of options but minimal learning curve and easy-to-use interface, they can offer more complex mocking scenarios during user interviews without spending too much time setting up throwaway mocks.
The result is thorough UX research by testing and validating more complex scenarios, accelerating feedback, and ensuring a high-quality release.
Impala has found that thanks to Mockoon's complete set of options, minimal learning curve, and easy-to-use interface, they can offer more complex mocking scenarios during user interviews without spending too much time setting up throwaway mocks. The result is thorough UX research by testing and validating more complex scenarios, accelerating feedback, and ensuring a high-quality release.

If you want to learn more about how Impala implemented their API user research workflow, you can read their [detailed article](https://impala.travel/en/blog/using-ux-research-to-build-apis-that-developers-love).
2 changes: 1 addition & 1 deletion pages/use-cases.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ const UseCases: FunctionComponent = function () {
ogType='article'
/>
<Hero
title='API mocking use cases'
title='API mocking <span class="text-primary">use cases</span>'
subtitle='Discover how mocking APIs with Mockoon can accelerate and streamline your applications development, integration, testing, and demos'
/>

Expand Down
14 changes: 5 additions & 9 deletions styles/_user.scss
Original file line number Diff line number Diff line change
Expand Up @@ -121,22 +121,18 @@ aside {
}
.article-header {
background: rgb(38, 40, 48);
background: linear-gradient(
90deg,
rgba(38, 40, 48, 1) 0%,
rgba(59, 164, 220, 1) 120%
);
color: #adeae1;
background: linear-gradient(90deg, #262830 0%, #3ba4dc 120%);
color: $gray-300;
text-align: left;

a {
color: #adeae1;
color: $gray-300;
&:visited {
color: #adeae1;
color: $gray-300;
}
&:hover,
&:active {
color: darken(#adeae1, 40%);
color: white;
}
}

Expand Down

0 comments on commit b645e8c

Please sign in to comment.