An AP(EYE) Toward the Revolution

AP(EYE) On the Revolution

Learning fromJonathan Ivethe Kano Model

Presented by Casey Wilms Product Manager at Brightcove

Wednesday, September 18, 13




API


API


API is an interface




Two users




What does this user want?


What does this user want?


API Design



Dieter RamsKano Model


Dieter Rams Industrial DesignKano Model Product


Five guiding principles


Specific examples


Discuss


Five guiding principles1. minimalism



Five guiding principles1. minimalism2. get out of the way


REST


Consistency


Dieter Rams


Jonathan Ive







Objectified (2009)


Objectified (2009)




Five guiding principles1. minimalism2. get out of the way3. design for extremes







Ben:

No, Ben, I went back over everything again and again,and still it didn't work. So, forget it Ben.

Just please see that my CC is not charged Ben.

I have no interest in your services Ben for this PWCart.

Maybe later for something else but I doubt it Ben.

I find your service lazy and incomplete.

Your support arrogant and not very knowledgeable.

Looking forward to never seeing your name and company in my inbox again,

Richard



Dim strPname As StringDim dblPrice As Double




POST /api/jobs HTTP/1.1Accept: application/jsonContent-Type: application/json

{ "api_key" : "does not exist", "color" : "green"}


HTTP/1.1 500 Internal Server Error


HTTP/1.1 401 Unauthorized



{ "errors": [ "api_key not found" ]}



{ "errors": [ "api_key not found.", "api_key may not include spaces." ]}



{ "errors": [ "api_key not found. Please log in to https://example.com/account/api to retrieve your API key.", "api_key may not include spaces." ]}


https://example.com/account/api




POST /api/user HTTP/1.1Accept: application/jsonContent-Type: application/json

{ "api_key" : "A23B92F281CC" "strength" : 18}


HTTP/1.1 400 Bad Request


HTTP/1.1 400 Bad Request

{ "errors": [ "JSON is not valid. Syntax error, unexpected TSTRING, expecting '}' at line 2" ]}



HTTP/1.1 200 OK


HTTP/1.1 503 Service Unavailable


HTTP/1.1 408 Request Timeout






https://api.example.com/v1


https://api.stripe.com/v1/charges



Five guiding principles1. minimalism2. get out of the way3. design for extremes4. be predictable


How do you charge money with Stripe?


What is the URL?What are the params?


curl https://api.stripe.com/v1/charges \ -u my_api_key: \ -d amount=20 \ -d currency=usd \ -d customer=12093155




KanoModel


NoriakiKano


NoriakiKano



Basic needs (must have)




Performance needs(one-dimensional)



Indifferent(don’t care)



Delighters(attractive, exciting)










Support



Focus on delight andperformance


Five guiding principles1. minimalism2. get out of the way3. design for extremes4. be predictable


Five guiding principles1. minimalism2. get out of the way3. design for extremes4. be predictable5. excite users


What do you think?


Thanks!

Presented by Casey WilmsPM at Brightcove


Technology

An AP(EYE) Toward the Revolution