1. API 101

3. APPLICATION
PROGRAMMING
INTERFACE
API ?
INTRODUCTION

4. An application programming interface (API) is a set
of subroutine definitions, protocols, and tools for
building application software. A good API makes it
easier to develop a computer program by providing
all the building blocks, which are then put together by
the programmer.
API ?
INTRODUCTION

5. APIS
ARE EVERYWHERE

6. TYPES
MANY TYPES
HARDWARD SOFTWARE WEB …

7. TYPES
AN API EXPOSE A SERVICE. A HARDWARE CONSOMME IT

8. TYPES
AN API EXPOSE A SERVICE. A PROGRAM CONSOMME IT

9. TYPES
AN API EXPOSE A SERVICE. A WEBSITE CONSOMME IT
API

10. TYPES
AN API EXPOSE A SERVICE. AN APP CONSOMME IT
API

11. CLIENT / SERVER

12. CLIENT/SERVER
AN API EXPOSE A SERVICE. A WEBSITE CONSOMME IT
API
API CLIENT
SERVICE
PROVIDER

13. APIS ORIGINS

14. APIS ORIGINS

15. API IS A
CONTRACT

16. NOT LIKE
WEBSITE

17. WEBSITE CONTRACT CHANGE SIDE EFFECT

18. API CONTRACT CHANGE SIDE EFFECT

19. API CONTRACT
CONTRACT
= TRUST

20. API = TRUST
CONTRACT
= DOC
= TOOLS …

21. CONTRACT =
PROTOCOL

22. THE RESTAURANT ANALOGY

23. THE RESTAURANT ANALOGY
API Providers = Restaurant Owners
Developer Portal = Restaurant
APIs = Food & Drink items
API definition + Doc = Menu
API consumers (Apps) = Restaurant consumers (people)
Terms of Service = We Reserve The Right To Refuse - No
Substitutions

24. THE RESTAURANT ANALOGY
HTTP
API Provider
API Response
HTTP
API ClientAPI Client
API Request

25. HTTP IS THE UNDERLYING PROTOCOL USED BY THE WORLD WIDE
WEB AND THIS PROTOCOL DEFINES HOW MESSAGES ARE
FORMATTED AND TRANSMITTED, AND WHAT ACTIONS WEB SERVERS
AND BROWSERS SHOULD TAKE IN RESPONSE.
HTTP
WHAT IS HTTP

26. HTTP
FOR HUMAINS

27. HTTP
FOR CATS

28. HTTP
FOR MACHINES
API ONLY PLEASE!

29. CONTRACT =
STYLE

30. REPRESENTATIONAL STATE
TRANSFER
REST
REST

31. REST
ROY FIELDING

32. REST
RESTFUL API = FOLLOW THE REST ARCHITECTURE STYLE

33. RESOURCES & METHODS
REST
REST

34. RESOURCES
TEXT, IMAGE, MUSIC, VIDEO… AVAILABLE WITH AN URL
URL = UNIFORM RESOURCE LOCATOR
https://api.service.com/toto http://www.dailymotion.com/embed/xxxx http://dm.com

35. METHODS
methods meaning
GET Order
POST Update
DELETE Cancel

36. REST
REST API REQUEST

37. I'M FAMOUS AND I KNOW IT

38. REST VS SOAP VS XMLRPC

39. REST VS SOAP
REST
SOAP / XMLRPC
DATA = MARTIN LAWRENCE

40. REST VS SOAP

41. GRAPHQL

42. GRAPHQL
A spec/style to design an API
Over HTTP
Used in Facebook’s native apps in production since 2012
Open sourced in July 2015

43. GRAPHQL

44. GRAPHQL
THE API CLIENT HAS MORE POWER

45. GRAPHQL
THE API CLIENT HAS MORE POWER

46. GRAPHQL VS REST
REST is here to stay
Simple
Widely used
GraphQL
different approach
The UI is the king
Solve some limits of REST

47. REPRESENTATIONS

48. TEXTE
HTTP
API provider
API Response
HTTP
API ClientAPI Client
API Request
PRESENTATION ?

49. JSON

50. JSON

51. XML

52. XML

53. DAILYMOTION APIS

55. DATA API
SOME INSIGHTS
‣200 million API requests / day
‣Average response time : 70ms
‣500K API Keys
‣14 million connected users

56. DATA API
WHAT FOR ?
‣Get video data, user, playlist
‣Search videos
‣Publish videos
‣Get streams
‣Manage users
‣More…

57. DATA API
REST CALL

58. DATA API
GRAPH

59. DATA API
CRUDL

60. DATA API
API EXPLORER

61. PLAYER API
WHAT FOR ?
‣Embed & Customise
‣Interact (Advanced)

62. PLAYER API
EMBED

63. PLAYER API
INTERACT
PLAYER API
LISTEN EVENTSSEND ACTIONS

64. DEMO - Q&A
THANK YOU