5 Features of a Good API

Rob Allen (10.Jun.2017 at 10:00, 50 min)
Talk at PHP South Coast 2017 (English - UK)

Rating: 5 of 5

Everyone is writing APIs from micro-services through to full applications, but what makes a good one? In this session we’ll look at five of the more important features that you should think about when creating an API. These are the features that ensure that your API plays well with HTTP and, more importantly, make your API a delight to maintain and work with. I want you to ensure that your API is a good HTTP citizen, while also providing developer-friendly features like thoughtful error handling and documentation. Give your API a competitive edge by making it sane so developers will want to work with it.

Who are you?

Claim talk

Talk claims have been moved to the new Joind.in site.

Please login to the new site to claim your talk

Comments closed.


Rating: 5 of 5

10.Jun.2017 at 10:56 by Sean Wallis (11 comments) via Web2 LIVE

Very clearly explained. Excellent responses to questions from someone that is very knowledgeable. Thank you very much Rob, I pledge to write better APIs.

Rating: 4 of 5

10.Jun.2017 at 11:02 by Daniele (1 comments) via Web2 LIVE

Great talk by someone who clearly has a lot of experience writing and interacting with APIs. Would have loved if he went a little bit more into details certain implementation choices and possibly different approaches for different cases (e.g. private APIs)

Rating: 5 of 5

10.Jun.2017 at 13:02 by Jason Stanley (5 comments) via Web2 LIVE

Great subject matter which was broken down into bite sized chunks and explained very clearly and concisely. Left me with some further reading. I enjoyed it a lot.

Rating: 5 of 5

10.Jun.2017 at 15:48 by Wim Godden (31 comments) via Web2 LIVE

Solid tips all the way

Rating: 5 of 5

10.Jun.2017 at 20:21 by Katy Ereira (65 comments) via Web2 LIVE

I came away with so many things to consider, and definitely will help me with developing APIs in the future. I also love Rob's presentation style; calm and informative but often amusing. :D

Rating: 5 of 5

10.Jun.2017 at 21:02 by Tim Stamp (23 comments) via Web2 LIVE

Some very insightful recommendations on good API design, many of which I will be practicing as soon as I get back to work.
Very much appreciated you sharing your experiences and recommendations on this.

Rating: 5 of 5

10.Jun.2017 at 22:44 by Chris Emerson (50 comments) via Web2 LIVE

Loads to think about here when implementing an API - much of which seems obvious, but its so easy to fall into the habit of not doing things properly if you don't keep an eye on it!

Rating: 5 of 5

10.Jun.2017 at 23:20 by Peter Fisher (50 comments) via Web2 LIVE

Thank you for a clear set of API recommendations.
I will be reading some of those RFC's in the coming days

Rating: 5 of 5

11.Jun.2017 at 09:55 by Jonathan Parker (20 comments) via Web2 LIVE

A well-crafted presentation on something which I guess needs to be well-crafted of itself. The questions afterwards were particularly well handled, I thought. I look forward to reading the RFCs!

Rating: 5 of 5

11.Jun.2017 at 10:14 by Khanh Nguyen (1 comments) via Web2 LIVE

Thanks for sharing

Rating: 4 of 5

11.Jun.2017 at 12:03 by Chris Sherry (80 comments) via Web2 LIVE

This talk is packed full of good advice and experience from Rob. The slides were excellent and content was well crafted.

My only criticism would be that the pace could be picked up a little - there were times of long pauses and I found my focus drifting more than I would have liked for the first talk of the day.

That said, a big thank you to Rob for standing in last minute to give this talk, and I enjoyed speaking to him in person in and around the conference.

Rating: 5 of 5

11.Jun.2017 at 12:14 by Daniel Craigie (20 comments)

Great talk, lots to think about when I next venture near the API...

Rating: 5 of 5

11.Jun.2017 at 12:56 by Lee Stone (19 comments) via Web2 LIVE

Firstly, I like the new slide style...
The talk itself was perfectly timed for me - we're quite early in the process of trying to design an API for our services and there is lots of information in here which I can now factor in to this.

Rating: 5 of 5

11.Jun.2017 at 18:45 by Lee Boynton (67 comments) via Web2 LIVE

I understand the talk had previously been given in a shorter duration, however I thought the pace of the talk was ok as this allowed time to think about what was being said.

It was good to know about the relevant RFCs, such as 7807. It would be interesting to know how they compare with the JSON API spec at http://jsonapi.org/format/

Rating: 5 of 5

12.Jun.2017 at 00:27 by Gary Jones (18 comments) via Web2 LIVE

I found the pace of the talk good and felt it was a slick presentation. Definitely aspects of this presentation I could use in current client work.

Rating: 5 of 5

12.Jun.2017 at 19:41 by Naomi Gotts (14 comments) via Web2 LIVE

Fantastic talk; well delivered, well structured, and really good timing for a project we are currently working on in the office. Writing this on Monday and have already used a few things learned from this talk on said project today.

Rating: 5 of 5

12.Jun.2017 at 20:52 by Mark Dain (5 comments) via Web2 LIVE

A great talk that was easy to follow and taught me a lot of things about HTTP and API design. Thank you for a fantastic talk!

Rating: 5 of 5

12.Jun.2017 at 21:03 by Dave Liddament (72 comments) via Web2 LIVE

Great talk. Lots of useful take aways, I might have to tweak a few APIs when I'm back in the office.

Rating: 5 of 5

15.Jun.2017 at 23:01 by Neil Nand (46 comments) via Web2 LIVE

Really good talk & made me think about some API design decisions in a different way.

Rating: 5 of 5

16.Jun.2017 at 10:05 by Feliksas Mazeikis (9 comments) via Web2 LIVE

A really good presentation, with a lot of good examples and tips.

Rating: 5 of 5

16.Jun.2017 at 11:01 by James Titcumb (280 comments) via Web2 LIVE

Well presented, great content. I learnt stuff, which is the right idea I suppose.

Rating: 5 of 5

18.Jun.2017 at 19:24 by Marcus Deglos (9 comments) via Web2 LIVE

Great explanation, with lots of actionable information. Really useful to see the RFCs referenced during the talk.
Very technology-agnostic; recommended viewing for anyone involved in designing or building an API.

© Joind.in 2019