My ideas around API design are always growing and changing, but I've definitely gone from API-first, to Docs-first, to now Spec-first when I work with APIs. I took the opportunity to cover some of the design choices for starting a … Continue reading
OK so it had a more strongly-worded title but that was not my idea :) I loved having a quick run through my favourite tools for the PHP[TEK] audience! View API Tools You Should be Using on Notist.
I've been working on a few OpenAPI descriptions of APIs lately, and really enjoying the benefits they bring. In particular the ability to import into Postman as a collection I think is a "killer feature" for APIs looking to get … Continue reading
Working with OpenAPI is bringing so many possibilities to the way that developers work with APIs, it's exciting! The spec is very comprehensive though and I've found myself answering questions on individual aspects of it recently, so I thought I'd … Continue reading
Describing your API opens the door to wonder and magic - and documentation of course. This talk is from the Tool the Docs room at FOSDEM.
Have you noticed that API providers are starting to offer "descriptions" of their APIs? These are usually OpenAPI specifications, computer-readable documents that describe every aspect of an API's endpoints. They can be used to generate documentation, SDKs, but now they … Continue reading
I'm working with a bunch of OpenAPI specs now I am working for Nexmo and so far I'm loving working with API descriptions. OpenAPI is the next iteration of what used to be called "Swagger", a machine-readable way to describe … Continue reading
The wonderful people at APItheDocs brought their event to London and accepted me as a speaker! Slides: https://speakerdeck.com/lornajane/introduction-to-openapi-specification Video:
I work quite a bit with serverless tech, particularly on IBM Cloud since I work there. At the moment I'm building a microservice using web actions. When a user creates data with a POST request, I want to redirect them … Continue reading
I'm working on a CouchDB library for PHP, and so I needed to write some tests for it. CouchDB has an HTTP API so I'm basically making web requests and while I could certainly set up a test database and … Continue reading