This document discusses APIs and how to design good APIs. It provides an introduction to APIs and mentions Victoria's email. It then discusses important aspects of APIs like HTTP verbs (GET, POST, PUT, DELETE), using cURL for HTTP requests, learning the API URL/endpoints/response formats. It shows examples of XML and JSON responses. It discusses using Elixir and libraries like HTTPotion and HTTPoison for making HTTP requests. It also mentions things to watch out for like URI encoding, caching, and checking the stability and community around libraries. It offers Victoria as a free mentor for women in tech in Warsaw.

1. an introduction
APIs(?!)
victoria@46elks.com

2. Victoria
* Developer at 46elks
* Elixir
* EL Passion

3. APIs
web

4. [ > ]
”How to design a good
API and why it matters”

5. APIs
web
HTTP

7. HTTP request

8. HTTP
verbs
aka
request methods

9. Ask for
Send
Update
Remove

10. Ask for
Send
Update
Remove
GET
POST
PUT
DELETE

13. cURL - Example
curl -X POST
-u <API Username>:<API Password>
-H "Content-Type: application/x-www-form-urlencoded"
-d "from=VILLE"
-d ”message=Hej%20Kul”
-d "to=+358503672181"
'https://api.46elks.com/a1/SMS'
Types
Auth Request
Content Type
Request Data
Endpoint
Service
Secure HTTP Socket

14. So where does
one start?

15. Learn about the API
• URL/base url
• Endpoint(s)
• Response format

16. http://
supernavet.skolverket.s
e/SusaNavExport/
EmilExporter
XML

17. <response>
<mobilenumber>+46766861004</mobilenumber>
<displayname>Victoria</displayname>
<currency>SEK</currency>
…
</response>
XML

18. [{
"mobilenumber": "+46766861004",
"displayname": "Victoria",
"costtype": "trial",
"id": "u471962a39cc22c97415c84be437",
"currency": "SEK",
"trialactivated": "2016-10-23T15:37",
"balance": 200000,
"email": "victoria+workshop@46elks.com"
},
{
…
}
]
json

19. mix new

20. mix new apifrenzy

21. mix new apifrenzy
cd apifrenzy
:e
/lib/apifrenzy/fetcher.ex

24. cd apifrenzy
iex -S mix

25. cd apifrenzy
iex -S mix
Apifrenzy.Fetcher.fetch_educational_resources

26. cd apifrenzy
iex -S mix
Apifrenzy.Fetcher.fetch_educational_resources
Fetching educational resources
from: http://
supernavet.skolverket.se/
SusaNavExport/EmilExporter
:ok

27. Can I haz
HTTP requests
in Elixir plz?

28. ”Elixir http”

29. Also a way to find
resources by category:
http://toolbox.elixir.pm/
by Henrik Nyh
https://github.com/henrik/toolbox

34. HTTPotion.
HTTPoison!
Tesla?

39. mix.exs

40. mix.exs

41. mix deps.get

43. mix.exs

45. cd apifrenzy
iex -S mix

46. cd apifrenzy
iex -S mix
Apifrenzy.Fetcher.fetch_educational_resources

50. Look at docs..
(documentation)

51. RTFM

53. HEX
DOCS

68. OK Nice!

69. OK Nice!

71. status code

72. Status code
200 - OK
404 - NOT found

73. 1xx Informational
2xx Success
3xx Redirection
4xx Client Error
5xx Server Error

74. 100 Keep sending
200 Success
301 Move to a different url
401 Unauthorized
500 Server Error
- ex: crashed whilst trying.

75. ” http status codes cats ”

76. https://http.cat/
https://http.cat/200

82. Let’s!

83. Self-service setup
46elks.com/signup

87. workshop

88. Gothchas & ahaaaa

89. URI encoded
x-www-form-urlencoded
json

93. Browsers caching
GET response

94. Keep an eye on repository
source code pages.
What is the activity?
Stable? Stale?
Community there?

95. Version number.
Poison is at 0.10 … Use at your own risk.
I’d say it depends on your confidence
and skills, are there still challenges that
simply haven’t been solved yet. You can
always check pull requests, and forks,
and of course ”reported issues” to see
what issues people have.

96. graphql.org

98. Free popup 1on1 teaching/
mentoring,
workshops/presentations for
women in Warszawa
victoria@46elks.com

99. TY
Available as mentor for free to
women in tech { Warszaw in December}
Victoria Wagman
victoria@46elks.com
46elks.pl open data