Detailed instructions on how to use API Value Proposition and API Business Model Canvases
Step 1: API Value Proposition Canvas
The API Value Proposition (AVP) Canvas helps your team to discover and scope the APIs and other services you need. It starts from the API consumer’s tasks, expected benefits (gains) and problems. Then it guides you to design your API features as solutions to those expectations.
Start from the right side of the AVP Canvas. It's important your team fills in the API Consumer view first. This will help innovate new ideas, focus on the exact behaviour, features and help needed and avoid building features that are not important.
See instructions below, with corresponding letters. Don’t be afraid of a few iterations with the templates. Use them also for interviewing required people, partners and teams to confirm ideas.
Section A: Tasks
What does the potential API consuming application need to do? Fill in a workflow of tasks when there is no API.
Section B: Gains - benefits for using API
Look at the task list. Analyze what are the benefits of using an API to do the tasks. Think from the API Consuming application team’s perspective. What don't they need to do themselves (assuming they even could do it)?
Section C: Pains- problems using API
Why would the team use the API? What problems do they see? Examples of problems:
Section D: Gain enabling features of the API
Match the expected gains with the gain enabling features of the API
Section E: Pain relieving features of the API
Match the expected pains with the pain-relieving features and resources (for example SDK, instructions…)
Section F: APIs and Services offering the gain enabling and pain-relieving features
List the APIs and other services required to fulfil the feature list. Remember no API is an island. Your API will need for example
identity and authentication services,
developer portal etc.
API Business Model Canvas
Read instructions below
Step 2: API Business Model Canvas – Center & Right
If you looked already at the API Business Model Canvas –template, you noticed that the areas are numbers. You should fill in all key information in the numbered order. Don’t be afraid to do a few iterations though.
Copy the main API(s) you are now focused on creating/updating to the API name field
Value proposition (1)
Write a short sentence based on the fields D and E telling the "what and why" of your API. Copy the feature fields D and E from the AVP Canvas to the Value proposition (1) field in API Canvas.
API Consumer Segments (2)
You have now looked at the problem from at least one customer segments perspective. Fill in API Consumer segments (2): what was the segment you thought about when doing the AVP Canvas? Who else could also use this API? This is a good place to talk to the people in charge of business development and partner relationships. Don’t forget also marketing and vendor management people.
Developer relations (3)
How do developers find the API? How to ensure API is usable for them, how to understand what it can be used for? How to test drive it? How is their subscription approved? Do they have to sign an agreement? How do they give feedback, see the roadmap, take part in the discussion?
The channels are the ways and places from which the developers find and can find, buy/request access to your API.
How does the API help you as an API Provider to create revenue (directly or indirectly)?
How can you reduce costs by offering an API?
How can the API Consumers create revenue or reduce costs by using the API?
Step 3: API Canvas – Left side
Key activities (6)
Look at the features in the Value proposition field. What do you need to build or create to achieve the features? Don’t forget platforms, testing environments, and other supporting elements. You might need to create also non-API things: agreement templates, marketing materials etc.
Key resources (7)
Look at the field F in the AVP Canvas. Are there any existing APIs or other services that you can use to create the new API –features? What existing platforms, backend integrations, document templates etc. will you use?
Key partners (8)
Think about partners in this case as internal and external people outside your team. Look at the Key activities, Key resources, and all the API Consumer related fields. With whom do you need to co-operate to make these API –features alive and usable for the intended API Consumers?
Cost structure (9)
You can either estimate the real costs or set maximum cost based on profit from the revenues. Figuring out real costs can be difficult before the architecture is designed. Remember the fixed monthly costs for running the architecture components. Also budget for continuous small development and maintenance. Include platform costs, licenses, and 3rd party API costs. The variable costs will usually increase to significant amounts per month when your API has over 1 million users.
SECTION 1 - WHAT DO WE DO WITH YOUR INFORMATION?
When you browse our website, we automatically receive your computer’s internet protocol (IP) address in order to provide us with information that helps us learn about your browser and operating system.
With your permission, we may send you emails about our site, new services, events and other updates.
SECTION 2 - CONSENT
How do you get my consent?
When you provide us with personal information to complete a transaction, verify your credit card, place an order, arrange for a delivery or return a purchase, we imply that you consent to our collecting it and using it for that specific reason only.
If we ask for your personal information for a secondary reason, like marketing, we will either ask you directly for your expressed consent, or provide you with an opportunity to say no.
How do I withdraw my consent?
If after you opt-in, you change your mind, you may withdraw your consent for us to contact you, for the continued collection, use or disclosure of your information, at anytime, by contacting us at [email protected]
SECTION 3 - DISCLOSURE
We may disclose your personal information if we are required by law to do so or if you violate our Terms of Service.
SECTION 4 – SERVICE PROVIDERS
Our website is hosted on Strikingly Inc., a Delaware, US based company. They provide us with the website platform including the subscription and web form data you submit to us.
We use Google’s application suite for email, documents and calendar and Campaign monitor for sending email campaigns. We only allow dedicated personnel to get access to these systems. Emails sent to our general email [email protected] are also stored in PlanMill, our ERP system, for customer service and archiving.
SECTION 5 - THIRD-PARTY SERVICES
In general, the third-party providers used by us will only collect, use and disclose your information to the extent necessary to allow them to perform the services they provide to us.
However, certain third-party service providers, such as payment gateways and other payment transaction processors, have their own privacy policies in respect to the information we are required to provide to them for your purchase-related transactions.
For these providers, we recommend that you read their privacy policies so you can understand the manner in which your personal information will be handled by these providers.
In particular, remember that certain providers may be located in or have facilities that are located a different jurisdiction than either you or us. So if you elect to proceed with a transaction that involves the services of a third-party service provider, then your information may become subject to the laws of the jurisdiction(s) in which that service provider or its facilities are located.
When you click on links on our store, they may direct you away from our site. We are not responsible for the privacy practices of other sites and encourage you to read their privacy statements.
SECTION 6 - SECURITY
To protect your personal information, we take reasonable precautions and follow industry best practices to make sure it is not inappropriately lost, misused, accessed, disclosed, altered or destroyed.
SECTION 7 - COOKIES
You are asked separately for accepting cookies on the site.
SECTION 8 - AGE OF CONSENT
By using this site, you represent that you are at least the age of majority in your state or province of residence, or that you are the age of majority in your state or province of residence and you have given us your consent to allow any of your minor dependents to use this site.
If our store is acquired or merged with another company, your information may be transferred to the new owners so that we may continue to sell products to you.
QUESTIONS AND CONTACT INFORMATION
If you would like to: access, correct, amend or delete any personal information we have about you, register a complaint, or simply want more information contact our Privacy Compliance Officer at [email protected]