Creating a JSON Patch endpoint in Go (2 mins read).
How to create a server-side JSON Patch API endpoint in Go.
RapiDoc is Web Component for viewing Swagger & OpenAPI Spec. Supports themes, styling and various rendering styles
Building a Go RESTful API with design-first OpenAPI contracts (6 mins read).
How to use
oapi-codegen to generate an RESTful API using design-first OpenAPI and code generation.
Shipping services more quickly with design-first OpenAPI contracts (8 mins read).
How using OpenAPI has led to being able to ship a new service more effectively, by removing the need to write scaffolding, and instead focus on the business logic.
Describing a multi-value querystring parameter in OpenAPI (1 mins read).
How to define a querystring parameter that has multiple values, in OpenAPI.
API Design tip: use objects for similar data (1 mins read).
Why you should use objects to nest similar data in JSON responses.
Describing JSON Patch operations with OpenAPI (2 mins read).
How to describe your JSON Patch endpoints using OpenAPI.
I feel comfortable using legal jargon in everyday life.
Joyce Lin (@PetuniaGray)Fri, 15 Apr 2022 02:00 +0000
An API needs designing. It needs a conscious language and consistent conventions. Standard auth. Paging. Careful error codes and messages. Versioning.
Jessica Joy Kerr (@jessitron)Thu, 16 Dec 2021 05:26 GMT
API-first. "Headless" e-commerce. "Headless" BI. We've seen a resurgence of startups reimagine startups like Shopify and Wordpress, but built for developers and built for composability. The API is the product. There's three major risks to building on an API. (1) Requests and responses aren't always the full contract. What happens
Recommended read: API Warfare https://matt-rickard.com/api-warfare/
Recommended read: How to design better APIs https://r.bluethl.net/how-to-design-better-apis
Recommended read: Why do we need API design guidelines? https://apihandyman.io/why-do-we-need-api-design-guidelines/
My colleague Bethan wrote about the work we're currently doing on Federated API Discovery across government. Very much recommend a read about why we're doing it, and we'll be doing more posts in the future about progress, but until then, you can check out the repo
Recommended read: Using a federated model for API discovery in government - Data in government https://dataingovernment.blog.gov.uk/2022/02/18/using-a-federated-model-for-api-discovery-in-government/
Recommended read: Patterns for Authorization in Microservices https://www.osohq.com/post/microservices-authorization-patterns
Recommended read: Request bodies in GET requests https://evertpot.com/get-request-bodies/
Recommended read: Contract Testing a Laravel API with OpenAPI | APIs You Won't Hate https://apisyouwonthate.com/blog/contract-testing-apis-laravel-php-openapi
Recommended read: Nobody cares about API design guidelines https://apihandyman.io/nobody-cares-about-api-design-guidelines/
Recommended read: Speed-Review API Specifications with Insomnia https://konghq.com/blog/api-specifications/
Recommended read: Securing Large API Ecosystems - The New Stack https://thenewstack.io/securing-large-api-ecosystems/
Recommended read: Guest Blog: Alissa Knight on 'FHIR Walker: Authentication and Authorization in FHIR APIs' https://securityboulevard.com/2021/05/guest-blog-alissa-knight-on-fhir-walker-authentication-and-authorization-in-fhir-apis/
The coronavirus API documentation, specifically, is the gold standard by which all API docs should be assessed. It’s clear! It generates URLs you can paste into your code! It regards helping people get to the info as a point, rather than seeing the API as an exam you have to pass
Post detailsSome personal news (a 🧵): On 4 October 2021, I resigned from my role as the Deputy Head of Software Engineering for Web and Data at @UKHSA. This means that 1 January 2022 will mark my final day in the agency — but *not* on the dashboard, so this is not goodbye. ...[1/10]
Pouria Hadjibagheri (@Pouriaaa)Fri, 24 Dec 2021 10:48 GMT
Chris Cook (@xtophercook)Fri, 24 Dec 2021 10:55 GMT
Recommended read: Defining an API management strategy - GOV.UK https://www.gov.uk/guidance/defining-an-api-management-strategy
Recommended read: Announcing WunderHub: Share APIs like they were npm packages https://wundergraph.com/blog/announcing_wunderhub_share_apis_like_they_were_npm_packages
API design is product design.
🎆🧁 Mark Dalgleish (@markdalgleish)Mon, 03 Jan 2022 07:54 GMT
Recommended read: Standards.REST https://standards.rest/
Recommended read: Refactoring an entire API Ecosystem https://phil.tech/2020/prioritizing-api-ecosystem-maturity/
Recommended read: Give me /events, not webhooks - Sequin https://blog.sequin.io/events-not-webhooks
Recommended read: Where does my validation live? https://blog.frankdejonge.nl/where-does-validation-live/
Recommended read: Give me /events, not webhooks https://blog.syncinc.so/events-not-webhooks
Recommended read: RFC6648: Deprecating the "X-" Prefix and Similar Constructs in Application Protocols https://datatracker.ietf.org/doc/html/rfc6648
You're currently viewing page 1 of 3, of 124 posts.