id
type
5
status
21
review version
0
cleanup version
0
pending deletion
0
created at
2025-05-04 10:15:57
updated at
2026-01-07 19:56:34
url
https://apisyouwonthate.com/blog/use-openapi-overlays-today/
url length
60
url crc
58583
url crc32
3089032407
location type
1
canonical status
10
canonical page id
domain id
domain tld
0
domain parts
0
originating warc id
-
originating url
https://apisyouwonthate.com/sitemap-posts.xml
source type
1
page id
title
Use OpenAPI Overlays Today
excerpt
content
It's been a while since OpenAPI v3.1 came out, an Project Moonwalk (OAS v4.0) is still in discussion and design phase, but that doesn't mean there's nothing new in the world of OpenAPI. Overlays are one of the OpenAPI Initiatives newest offerings, and I've already been using them to solve problems.Overlays are a way to "patch" an OpenAPI document, by pointing to a specific part of it with a JSONPath, then using "actions" to update or remove parts of the document. Why would anyone want to do this?Technical WritersPerhaps you're a technical writer trying to improve the OpenAPI-based documentation, but the OpenAPI is being generated from source code, and you don't fancy learning 5 different programming languages, web frameworks, and OpenAPI annotation frameworks. Fair enough!Instead of having your changes overridden, you can put all of your expanded guides and descriptions into an overlay, and have CI patch them together before deploying to your documentat...
author
updated
1768405455
block type
0
extracted fields
233
extracted bits
featured image
title
full content
content was extracted heuristically
OpenGraph suggests this is an article
detected location
0
detected language
1 (English)
category id
-
index version
1
paywall score
0
spam phrases
0
text nonlatin
0
text cyrillic
0
text characters
9230
text words
1842
text unique words
661
text lines
1
text sentences
34
text paragraphs
1
text words per sentence
54
text matched phrases
0
text matched dictionaries
0
links self subdomains
0
links other subdomains
6
links other domains
24
links spam adult
0
links spam random
0
links spam expired
0
links ext activities
0
links ext ecommerce
0
links ext finance
0
links ext crypto
0
links ext booking
0
links ext news
0
links ext leaks
0
links ext ugc
7
links ext klim
0
links ext generic
0
image author