An API value proposition canvas connects consumer jobs, pains, and desired gains with the API capabilities and internal resources intended to create value. Use it early in API design to align engineers, architects, product managers, business sponsors, and other stakeholders. section 5.2.3
Build the canvas from two profiles joined by a value statement:
- Consumer profile: record the jobs the consumer must complete, the pains encountered, and the gains sought. section 5.2.3
- Value map: identify data sources, internal APIs, applications, and processes that can relieve pains or create gains. section 5.2.3
- Interface: state the value the API provides by explaining how its features address consumer pains and gains. section 5.2.3
Product Catalog API
A Product Catalog API helps customers discover pet products. Its job stories cover browsing by category and searching for products; search is deferred to phase 2. The API combines internal Products, Catalog, and Reviews microservices.
