apinf / platform

Apinf - Open source API management platform with multi proxy and protocol support
https://apinf.com/
European Union Public License 1.1
74 stars 35 forks source link

create a persona for API owner #2406

Closed Nazarah closed 7 years ago

Nazarah commented 7 years ago

Related Customer Journey

Nazarah commented 7 years ago

img_9970

Nazia Hasan

Nationality: Bangladesh Age: 25 Expertise: Doing her Masters Thesis on Human Centered Design (UX Major) from TTY, Finland; Android Designing Occupation: UX Designer at "XYZ" startup Hobbies: Cooking, MakeUp and Reading

Preference:

Scenario: As an UX designer, Nazia feels that she should atleast have minimal knowledge about how API works before she can start designing Applications. She starts by creating a Swagger parser to make an API based on design. She asks around her colleagues if someone knows about it but unfortunately doesn't get much help. She googles "How to create swagger documentation"

She checks a result at swagger.io pointing at "Getting-started", but soon realizes this is not an actual tutorial. She checks another result containing an article about writing an open-API using swagger ad finds out this is a tutorial she is looking for. She starts reading it, but realizes that its actually more complicated than she thought so. Still she creates a new file with Swagger editor with some basic information and an end point already existing in her comapny's app.

As Nazia now has a simple but functional Swagger API, she looks for a mean to host the file. She finds out SwaggerHub and Github. But she realizes SwaggerHub is really complex to her and GitHub doesn't render a swagger file. She checks the google results and sees API hosting platforms like IBM, Amazon and a relatively new one called APInf. She wants to use IBM or Amazon 1st, but realizes she needs to start paying for it. so she gives a try to APInf, although she is skeptical about how trust worthy the Platform is.

Nazia hosts her swagger file and shares it with her colleagues. She also becomes curious about what APInf offers. She start thinking that as an API owner what might be her responsibilities to manage her API and starts looking for tutorials across the platform. She checks out 1-2 public API and but doesn't see that much of tutorial materials. She comes across a Dashboard menu but sees only a message prompting her to enable a proxy for her API. She doesn't have a clue how a proxy works and is stuck there.

Nazarah commented 7 years ago

closing the issue with a few review remarks from @philippeluickx