Jamie Tanna | Software Engineer

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.

Tue, 12 Jul 2022 15:54 by Jamie Tanna . #blogumentation #openapi #go #api.

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.

Mon, 27 Jun 2022 16:27 by Jamie Tanna . #deliveroo #openapi #go #api.

Describing a multi-value querystring parameter in OpenAPI (1 mins read).

How to define a querystring parameter that has multiple values, in OpenAPI.

Wed, 22 Jun 2022 18:24 by Jamie Tanna . #blogumentation #openapi #api #json-patch.

API Design tip: use objects for similar data (1 mins read).

Why you should use objects to nest similar data in JSON responses.

Thu, 02 Jun 2022 17:21 by Jamie Tanna . #api.

Describing JSON Patch operations with OpenAPI (2 mins read).

How to describe your JSON Patch endpoints using OpenAPI.

Sun, 29 May 2022 14:27 by Jamie Tanna . #blogumentation #openapi #api #json-patch.

Liked https://github.com/danielgtaylor/huma/ .

Sat, 21 May 2022 08:33 by Jamie Tanna . #go #api.

Post details

I feel comfortable using legal jargon in everyday life.
Joyce Lin (@PetuniaGray)Fri, 15 Apr 2022 02:00 +0000

Fri, 15 Apr 2022 20:59 by Jamie Tanna . #licensing #api #copyright #tiktok.

Post details

https://twitter.com/jessitron/status/1471351023033720834
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

Fri, 15 Apr 2022 10:18 by Jamie Tanna . #api.

Liked https://www.apiscene.io/api-business-models/i-have-read-the-api-terms-of-service-the-biggest-lie-of-the-programmable-web/ .

Bookmarked API Warfare

Post details

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/

Fri, 18 Mar 2022 08:28 by Jamie Tanna . #api.

Mon, 14 Mar 2022 18:12 by Jamie Tanna . #api.

Liked https://www.ukauthority.com/articles/data-standards-authority-works-on-federated-apis/ .

Bookmarked https://r.bluethl.net/how-to-design-better-apis .

Recommended read: How to design better APIs https://r.bluethl.net/how-to-design-better-apis

Sat, 12 Mar 2022 10:19 by Jamie Tanna . #api.

Thu, 24 Feb 2022 17:45 by Jamie Tanna . #api #gov.uk.

Bookmarked https://apihandyman.io/why-do-we-need-api-design-guidelines/ .

Recommended read: Why do we need API design guidelines? https://apihandyman.io/why-do-we-need-api-design-guidelines/

Wed, 23 Feb 2022 13:46 by Jamie Tanna . #api #api-governance.

Liked https://onesprintatatime.com/driving-meaningful-customer-impact-with-api-governance .

Bookmarked https://dataingovernment.blog.gov.uk/2022/02/18/using-a-federated-model-for-api-discovery-in-government/ .

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/

Fri, 18 Feb 2022 14:32 by Jamie Tanna . #cddo #gov.uk #api.

Liked https://developer.okta.com/blog/2022/02/08/cookies-vs-tokens .

Sat, 12 Feb 2022 12:11 by Jamie Tanna . #authentication #cookies #api #jwt.

Liked https://devops.com/trends-in-the-api-industry/ .

Sat, 12 Feb 2022 11:56 by Jamie Tanna . #api.

Sat, 12 Feb 2022 11:52 by Jamie Tanna . #api #api-governance.

Liked https://thenewstack.io/creating-an-api-first-culture-and-company-part-1/ .

Sat, 12 Feb 2022 11:49 by Jamie Tanna . #api.

Bookmarked https://www.osohq.com/post/microservices-authorization-patterns .

Recommended read: Patterns for Authorization in Microservices https://www.osohq.com/post/microservices-authorization-patterns

Fri, 11 Feb 2022 14:55 by Jamie Tanna . #microservices #authentication #authorization #api.

Bookmarked https://evertpot.com/get-request-bodies/ .

Recommended read: Request bodies in GET requests https://evertpot.com/get-request-bodies/

Thu, 10 Feb 2022 14:07 by Jamie Tanna . #api #http.

Liked https://apihandyman.io/what-should-come-first-when-designing-an-api/ .

Thu, 10 Feb 2022 07:56 by Jamie Tanna . #api.

Liked https://apievangelist.com/2022/01/23/beyond-api-design-governance-and-moving-towards-operational-api-governance/ .

Bookmarked https://apisyouwonthate.com/blog/contract-testing-apis-laravel-php-openapi .

Recommended read: Contract Testing a Laravel API with OpenAPI | APIs You Won't Hate https://apisyouwonthate.com/blog/contract-testing-apis-laravel-php-openapi

Sat, 05 Feb 2022 21:55 by Jamie Tanna . #openapi #api #testing.

Sat, 29 Jan 2022 09:54 by Jamie Tanna . #api #api-governance.

Liked https://apihandyman.io/what-to-consider-when-building-an-api-sandbox/ .

Wed, 26 Jan 2022 14:08 by Jamie Tanna . #api.

Liked https://apihandyman.io/a-few-concerns-to-be-aware-of-when-adding-try-it-feature-to-api-documentation/ .

Wed, 26 Jan 2022 14:06 by Jamie Tanna . #api.

Liked https://github.com/tiangolo/fastapi .

Tue, 25 Jan 2022 11:01 by Jamie Tanna . #python #api.

Liked https://github.com/VictorianGovernment/api-design-standards .

Wed, 19 Jan 2022 14:01 by Jamie Tanna . #api.

Liked https://restfulapi.net/ .

Wed, 19 Jan 2022 13:54 by Jamie Tanna . #rest #api.

Liked https://apievangelist.com/2022/01/14/you-are-api-first/ .

Sun, 16 Jan 2022 17:31 by Jamie Tanna . #api.

Bookmarked https://apihandyman.io/nobody-cares-about-api-design-guidelines/ .

Recommended read: Nobody cares about API design guidelines https://apihandyman.io/nobody-cares-about-api-design-guidelines/

Wed, 12 Jan 2022 18:37 by Jamie Tanna . #api.

Liked https://www.http-feeds.org/ .

Wed, 12 Jan 2022 09:51 by Jamie Tanna . #api #feed.

Bookmarked https://konghq.com/blog/api-specifications/ .

Recommended read: Speed-Review API Specifications with Insomnia https://konghq.com/blog/api-specifications/

Wed, 12 Jan 2022 08:11 by Jamie Tanna . #insomnia #api.

Bookmarked https://thenewstack.io/securing-large-api-ecosystems/ .

Recommended read: Securing Large API Ecosystems - The New Stack https://thenewstack.io/securing-large-api-ecosystems/

Wed, 05 Jan 2022 19:00 by Jamie Tanna . #api #security.

Bookmarked https://securityboulevard.com/2021/05/guest-blog-alissa-knight-on-fhir-walker-authentication-and-authorization-in-fhir-apis/ .

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/

Wed, 05 Jan 2022 08:33 by Jamie Tanna . #authentication #authorization #fhir #api.

Post details

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 details
Some 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

Tue, 04 Jan 2022 10:10 by Jamie Tanna . #api #coronavirus.

Bookmarked https://www.gov.uk/guidance/defining-an-api-management-strategy .

Recommended read: Defining an API management strategy - GOV.UK https://www.gov.uk/guidance/defining-an-api-management-strategy

Tue, 04 Jan 2022 10:03 by Jamie Tanna . #api.

Bookmarked https://wundergraph.com/blog/announcing_wunderhub_share_apis_like_they_were_npm_packages .

Recommended read: Announcing WunderHub: Share APIs like they were npm packages https://wundergraph.com/blog/announcing_wunderhub_share_apis_like_they_were_npm_packages

Tue, 04 Jan 2022 08:22 by Jamie Tanna . #api.

Post details

API design is product design.
🎆🧁 Mark Dalgleish (@markdalgleish)Mon, 03 Jan 2022 07:54 GMT

Mon, 03 Jan 2022 10:50 by Jamie Tanna . #api #product.

Bookmarked https://standards.rest/ .

Recommended read: Standards.REST https://standards.rest/

Mon, 03 Jan 2022 09:18 by Jamie Tanna . #api #rest.

Bookmarked https://phil.tech/2020/prioritizing-api-ecosystem-maturity/ .

Recommended read: Refactoring an entire API Ecosystem https://phil.tech/2020/prioritizing-api-ecosystem-maturity/

Mon, 03 Jan 2022 09:08 by Jamie Tanna . #api #api-governance #documentation.

Bookmarked https://blog.sequin.io/events-not-webhooks .

Recommended read: Give me /events, not webhooks - Sequin https://blog.sequin.io/events-not-webhooks

Tue, 28 Dec 2021 11:53 by Jamie Tanna . #webhooks #api.

Bookmarked https://blog.frankdejonge.nl/where-does-validation-live/ .

Recommended read: Where does my validation live? https://blog.frankdejonge.nl/where-does-validation-live/

Tue, 28 Dec 2021 11:17 by Jamie Tanna . #api.

Bookmarked https://blog.syncinc.so/events-not-webhooks .

Recommended read: Give me /events, not webhooks https://blog.syncinc.so/events-not-webhooks

Tue, 28 Dec 2021 10:53 by Jamie Tanna . #api #webhooks.

Liked https://nordicapis.com/everything-you-need-to-know-about-api-discovery/ .

Tue, 28 Dec 2021 10:52 by Jamie Tanna . #api.