APIs are not only Application Programming Iinterfaces. They define also contract between an provider and a customer/user, why we need a developer portal to define this contract, more than the interface itself. More of that Http calls are alien into the developer code, where he is now used to use objects. This talk shows how we could leverage containers abstraction for APIs to improve Developer Experience and simplify Developers Portals and http APIs integration, among the supply chain of "Code Delivery" into web or mobile apps.

1. Containerization of APIs
to improve
Developer Experience
Make the API economy Bigger

2. @medjawii

3. Mashup for fun & profit

4. 20TH CENTURY SUPPLY CHAIN

5. 21TH CENTURY SUPPLY CHAIN

6. From
Industry Supply chain
management
to
Data Supply chain
management

7. Phoenicians : 3000 BC

8. November 14th, 1913

9. November 14th, 1913

11. From 1926 to 1929, Seatrain Lines had carried
railroad boxcars on its sea vessels to transport goods
between New York and Cuba. #FAIL
In the mid-1930s, the Chicago Great Western Railway
and then the New Haven railroad began piggy-back
service limited to their own railroad. #FAIL

12. 1934 : Malcom
McLean creates
McLean Trucks, Co

13. 1939-1945

14. “Give me Liberty or give me Death”

15. 1950’

16. Shipping costs
$$$

17. - On a delivery from Chicago to Nancy, France, 48%
of the shipping price is the total port cost
- 75% of the cost of port cost is due when the ship is
at dock.
- shipping costs can go up to 25% of the goods value,
so blocking the international trade to be not
worthwhile

18. “As sexy as a tin can”
Marc Levinson

19. 1955 : Malcolm Mc
Lean sells McLean
Trucks and creates
Waterman Corp.

20. 1956 : price comparison

21. 1956 : price per ton shipped
$5.86
$0.16

23. Shipping data and services :
Containers for APIs ?

24. Classical products distribution
Web service distributed via an API
API

25. Classical products distribution
Web service distributed via an API
API

26. 1) Developers portals are a DX bug

32. http
API
API
APIkey
API
endpoint
documentation registration Authorization
discovery
integration

33. Developer Experience
Programming
costs
$$$

34. In a Developer Experience
perspective, a developer
portal is a bug, not a
feature.

35. “As a user, this is a bug not
a feature”
This is why iPhone 5s has TouchID for UX,
not for security !

36. Why?
Developer portals are a
compromise between API
providers and Developers
on defining a contract.

37. - an API is not only an
Application Programming
Interface
It is a contract.

38. - an API is an API +
Service + Pricing model + Terms
of service + Marketing/Branding
+ Humans

39. 2) http calls are “aliens” in
code

40. http://stackoverflow.com/questions/2138527/php-curl-http-post-sample-code

43. http is good for
interoperability and the
network, not for the DX.
It is also a compromise.
It’s OK.
200 OK.

44. If we had a Dev DX magic
stick, APIs should be
librairies.
v1.0

45. If we had a Dev DX magic
stick, APIs should be
librairies.

46. What are the potential
containers of APIs?

47. - Rest APIs
abstraction
- Objects
- Components
- Linux Containers

48. api.container.com/resource/{service_provider}

50. apis.google.maps()
apis.facebook.getFriends()
apis.twitter.auth()

51. We strongly recommend using the client
libraries listed above for building AdWords
API applications. If you would prefer to use a
SOAP toolkit to directly interact with the
API, read these language-specific
instructions for further details.

52. Developer
Javascript API
http calls

53. Not all languages are represented
into SDK
There are 2nd class Developers

54. Not all languages are represented
into SDK...
There are 2nd class Developers
(no troll)

55. API endpoint description
WSDL
WADL
Swagger
Blueprint
RAML
Javascript wrappers
conf.json

56. API endpoint description
WSDL
We could generate
WADL
SDK out of these
Swagger
API description
Blueprint
models for all
RAML
languages
Javascript wrappers
conf.json

57. Bonus : Code complete

58. Widgets
Components

59. Linux Containers