Workshop summary

Hej!

I hope you discovered and learned new things during the workshop!

Resources:

Finding APIs

• apikatalogen.se
• 46elks - sms & phone calls api

Open data

• hackforsweden.se Klick “participate”/”delta” in the menu and then data.
• trafiklab.se

Tools

• postman

Terminology

URL

The address to the system you’re talking to, just like addresses to a website.
Example: website: https://www.46elks.com, address to the api: https://api.46elks.com

basic auth

Authenticating yourself when sending a request. Example: https://username:password@api.46elks.com/a1/SMS

GET, POST, PUT, DELETE

Indicates what type of a request you’re making GET - ask for data. POST - enter new data PUT - update data DELETE - remove data

REST - if the api is a RESTful api, you can expect it to work something like this:

POST api.someservice.com/member
– creates a new member. (You need to send in data of course (parameters)). The service will likely reply with an ID, for example “13”.

GET api.someservice.com/member/13
– asks for details about that member.

GET api.someservice.com/member
– will likely show you a list of all members.

PUT api.someservice.com/member/13 – send in data (parameters) to update member nr 13.

DELETE api.someservice.com/member/13
– remove member 13 from database.

• what restful actually means
• best practices for a pragmatic restful api

Status codes

Indicates how your request went.
200 - all is well!
404 - couldn’t find it!
40x - you’re making a request in an unexpected way
50x - the system is not behaving as it should.
For specific examples, illustrated with cat pictures, see http cat.

Code examples

Code examples by 46elks
Many programming languages available, among others:
elixir, java, Node, PHP, python and ruby.

GL HF with your projects! :]

Regards,
Victoria - 46elks