Elixir & apis - presentation at ElixirConf 2016
99
-
Upload
victoria-wagman -
Category
Technology
-
view
38 -
download
1
Transcript of Elixir & apis - presentation at ElixirConf 2016
Victoria * Developer at 46elks * Elixir * EL Passion
APIsweb
[ > ] ”How to design a good API and why it matters”
APIsweb
HTTP
HTTP request
HTTP verbs
aka request methods
Ask for Send Update Remove
Ask for Send Update Remove
GET POST PUT DELETE
cURL - Examplecurl -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
EndpointService
Secure HTTP Socket
So where does one start?
Learn about the API • URL/base url • Endpoint(s) • Response format
http://supernavet.skolverket.se/SusaNavExport/EmilExporter
XML
<response> <mobilenumber>+46766861004</mobilenumber> <displayname>Victoria</displayname> <currency>SEK</currency> … </response>
XML
[{ "mobilenumber": "+46766861004", "displayname": "Victoria", "costtype": "trial", "id": "u471962a39cc22c97415c84be437", "currency": "SEK", "trialactivated": "2016-10-23T15:37", "balance": 200000, "email": "[email protected]" }, { … } ]
json
mix new
mix new apifrenzy
mix new apifrenzy cd apifrenzy
:e /lib/apifrenzy/fetcher.ex
cd apifrenzy iex -S mix
cd apifrenzy iex -S mix Apifrenzy.Fetcher.fetch_educational_resources
cd apifrenzy iex -S mix Apifrenzy.Fetcher.fetch_educational_resources
Fetching educational resources from: http://supernavet.skolverket.se/SusaNavExport/EmilExporter
:ok
Can I haz HTTP requests in Elixir plz?
”Elixir http”
Also a way to find resources by category: http://toolbox.elixir.pm/ by Henrik Nyh https://github.com/henrik/toolbox
HTTPotion. HTTPoison! Tesla?
mix.exs
mix.exs
mix deps.get
mix.exs
cd apifrenzy iex -S mix
cd apifrenzy iex -S mix Apifrenzy.Fetcher.fetch_educational_resources
Look at docs.. (documentation)
RTFM
HEX DOCS
OK Nice!
OK Nice!
status code
Status code200 - OK404 - NOT found
1xx Informational 2xx Success 3xx Redirection 4xx Client Error 5xx Server Error
100 Keep sending 200 Success 301 Move to a different url 401 Unauthorized 500 Server Error - ex: crashed whilst trying.
” http status codes cats ”
https://http.cat/ https://http.cat/200
Let’s!
Self-service setup
46elks.com/signup
workshop
Gothchas & ahaaaa
URI encoded x-www-form-urlencoded
json
Browsers caching
GET response
Keep an eye on repository source code pages. What is the activity?
Stable? Stale? Community there?
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.
graphql.org
Free popup 1on1 teaching/ mentoring, workshops/presentations for women in Warszawa [email protected]
TYAvailable as mentor for free to women in tech { Warszaw in December}Victoria [email protected]
46elks.pl open data
