apidays New York 2023 - Hypermedia as the engine for Customer Success, Michael Hibay, WSFS Bank

apidays New York 2023
APIs for Embedded Business Models: Finance, Healthcare, Retail, and Media
May 16 & 17, 2023

Hypermedia as the engine for Customer Success
Michael Hibay, API Platform Architect at WSFS Bank

------

Check out our conferences at https://www.apidays.global/

Do you want to sponsor or talk at one of our conferences?
https://apidays.typeform.com/to/ILJeAaV8

Learn more on APIscene, the global media made by the community for the community:
https://www.apiscene.io

Explore the API ecosystem with the API Landscape:
https://apilandscape.apiscene.io/

Transcript

1. HYPERMEDIA AS THE ENGINE FOR CUSTOMER SUCCESS Mike Hibay API Platform Architect WSFS Bank
2. REAL FAKE DISCLAIMER The following is a fictionalized true story to protect the identities, and IP, of all parties.
3. KEY QUESTION • As an [insert role here], how do you know your customers and consumers are successful?
4. THE ACTORS Consumers Enterprise Blog Post Publishers Customers Blog Post Authors The Regulators Enterprise Blogging and Author Protection Agency
5. THE SITUATION Author Signup Post Writing Submission Evaluation Acceptance Publishing Payment
6. IN OTHER WORDS
7. THE SITUATION Author Signup Post Writing Submission Evaluation Acceptance Publishing Payment
8. APPROXIMATE, CONTEXTUAL, & INCIDENTAL EQUIVALENCE 1 = 1 1 = 1.0 1 = “one” 1 = “1” 1 = 2/2 1 = “onE”
9. PUBLISHED WHAT DOES IT EVEN MEAN? Customers Post Submitted Consumers Post Ready for Author Payout Regulators Viewable & Post Author Paid out
10. ENGAGEMENT++ Describe Ideal Flow Identify Ambiguous Concept Define Terms for All Concepts
11. IMPROVED FLOW Author Signup Author Evaluation Author Approval Author Acceptance Post Writing Post Submission Post Evaluation Post Approval Post Acceptance Published Post Availability Author Payment Campaign Go-Live
12. VOCABULARY Words Things Messages Actors Roles Capabilities
13. CLICKABLE UI DEMO PAGES Schema V1 • Properties • Name: FirstProperty – String • Name: 2Property – String • Rendered UI Elements • Label (“First Property”): (Textbox) • Label (“2Property”): (Textbox) Schema V2 • Properties • Name: FirstProperty – String • Name: 2Property – String • Name: ListProperty - Enum • Rendered UI Elements • Label (“First Property”): (Textbox) • Label (“2Property”): (Textbox) • Label (“ListProperty”): (Dropdown)
14. UI PROCESS Content Negotiation •Vocab •Protocol Binding Resource Interaction •Discover State Show Affordances •Get Message Type •Get Message Schema
15. TWO BIG POINTS • The user experience implicitly matches the flow’s business outcomes. It’s literally defined by the real flow. • Early UI Iterations Clickable Demo UI Pages • Real Client, messages, types, and schemas!
16. RAPID PROTOTYPING Present Flow Check Process Fitness Update Vocabulary Update Messages & Schemas Update Flow Definitions
17. REQUIREMENTS Customer Presented Co-Created
18. WHERE IS ALL THE HYPERMEDIA? • It’s the means not the ends. The UI uses hypermedia to function. • If you can use it for UI, where else can you use it?
19. TYPICAL DEVELOPMENT PLAN Week 1 2 3 4 5 6 7 8 9 Design Dev QA Perf Security Ops
20. HYPERMEDIA DEVELOPMENT PLAN Week 1 2 3 4 5 6 7 8 9 Design Dev QA Perf Security Ops
21. THE PHILOSOPHY BEHIND THE STRATEGY Reduce Ambiguity
22. WHAT ARE THE PRACTICAL BENEFITS TO DEVELOPERS? Automation Increased Automation – Fewer Tasks means Less Work to do Stakeholders Decreased Stakeholder Coupling – Means more work completed Sooner Value Delivery Increased Value Delivery Velocity – Complete More Higher Value Work Faster
23. THE IMPORTANT BITS • Your API Design leads to unambiguous implementations of the consumer’s business objectives. • Your design is constantly evolving to better match the consumer’s business objectives, choices, challenges, and outcomes. • Conversational API Design: • Greater automation potential lowers the risk & rework cost associated with changes over time. • Gives major stakeholders significantly increased flexibility & time to contribute to the platforms success.
24. KEY QUESTION - ANSWERED • As an [insert role here], how do you know your customers and consumers are successful? • They told you they are!
25. THANK YOU! • https://blog.michaelhibay.com • https://github.com/hibaymj • https://twitter.com/hibaymj • https://www.linkedin.com/in/michael-hibay-362b2461 • https://www.wsfsbank.com/about-us/careers