Explore

@a43ti.bsky.social Oct 6, 2026, 7:55 AM

(part 2 of #swagger post above 👆)

besides OneOf, also figured out how to add:

- controller description
- non-default content type
- custom schema filter (to show the OneOf properly)

have some more related pics

#buildinpublic #dev #documentation #api #json #backend #http #dotnet #aspnetcore

the custom schema filter, which upon encountering that "flexible" type shows oneOf schema with 2 other types instead of showing properties as usual (that "flexible" type has no properties)

code fragment in program cs where I add swagger, include comments to it and add the custom schema filter from previous pic

total top view of the endpoints in swagger now

all used schemas listed under endpoints in swagger. as I said in the previous post, couldn't figure out how to hide that intermediate oneOf type

@a43ti.bsky.social Oct 6, 2026, 1:35 AM

I continue documenting #API s with #swagger and this time it's maritime project! ^^ and this was complex I must say despite so few endpoints

main achievement here is showing polymorphic (OneOf) schema, for an endpoint returning 2 types of payloads

#buildinpublic #dev #documentation #json #backend

endpoint to get data about all ports. used to load markers on the map. its the only endpoint in its controller so far. as you can see, description and response schema added - what I already learnt on previous API. but a description for a controller is new :)

endpoint for streaming spatial data of chunks of marine economical zones (eez) inside a given viewport. in practice the viewport is basically ya screen. here its a part 1 screenshot, I added description to the endpoint and parameters. the last 4 ones are actually from a viewmodel instance in code, had to document the viewmodel class - descriptions of these 4 params are summaries of its properties

part 2 screenshot of the streaming EEZ data endpoint. BEHOLD the 2 in 1 schema. 1st type of response carries actual GeoJSON, the 2nd type is a command to delete some existing chunk from map. the root type FlexibleSpatialResponse is not a real response type, in code its an empty class, exists only for documentation generation purposes... and couldn't find better way to show the 2in1 other than tell about it in response description 😅

endpoint for getting info which EEZ if any, there is in a given point. in practice used on click on map as a part of point information feature... nothing extraordinary here as you can see, nice additions of description, params descriptions, response schema

@shewandersferal.mu.social Oct 3, 2026, 3:10 PM

🎼Who sets the standard, #Kash?
Who writes the screen?
Who gets ruled out?
Who gets called ‘clean’?

You hand out #guns
You hand out #warrants
You send them through our doors

If screening bends around #statepower
What the fuck is screening for?
🎶
#Swagger isnt #knowledge
#Vengeance isnt #Justice🎶

@azure.blog.nubivagant.online.ap.brid.gy Sep 29, 2026, 12:46 AM

dropped my phone on my face #swagger

@supersqa.com Sep 29, 2026, 12:07 AM

Test APIs directly from your browser with Swagger! Make calls, view schemas, and get responses instantly. #API #Swagger

@dmitry-pavlov.bsky.social Sep 23, 2026, 8:40 AM

#Swagger vs. #Scalar: A comparison for #ASPNETCore developers

blog.elmah.io/swagger-vs-s... by Ali Hamza Ansar via @elmah.io blog

@a43ti.bsky.social Sep 23, 2026, 1:00 AM

dug up this rather old little #api about exchange rates and practiced adding #swagger documentation to endpoints :]

it was unexpectedly hard to find info how to link the xml summaries to swagger!! so I present you in the 1st pic, .csproj + SwaggerGen options

#buildinpublic #dev #dotnet #aspnetcore

configuration lines to link xml documentation of controller methods to swagger ui. a file with said xml can generate at project build in the output folder (debug/release/publish), next to .exe and all that. in .csproj one should enable this generation. then in program.cs, path to generated file is injected into options of SwaggerGen middleware.

api endpoints described in swagger, 1/3...

api endpoints described in swagger, 2/3...

Swagger UIとは

#swagger

@jguadagno.com Sep 9, 2026, 9:00 AM

ICYMI: (06/03/2022): "Enabling user authentication in Swagger using Microsoft Identity." RPs and feedback are always appreciated! https://jjg.me/3m9Ar02 #Articles #Entra #Identity #Managed Identity #MSAL #swagger

@victorribera.bsky.social Sep 8, 2026, 8:07 AM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 08-Sep-2026 09:10:32 CEST
Estat: en marxa usant motor
Velocitat: 0.1 kts
Direcció: 249 deg
Destinació: PALMA
Distància: 317.9 nm
Senyal RSSI: -19.3 dBFS
Vaixell AIS VesselAle

@victorribera.bsky.social Sep 8, 2026, 7:01 AM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 08-Sep-2026 08:04:10 CEST
Estat: en marxa usant motor
Velocitat: 0.1 kts
Direcció: 249 deg
Destinació: PALMA
Distància: 317.9 nm
Senyal RSSI: -19.3 dBFS
Vaixell AIS VesselAle

@victorribera.bsky.social Sep 8, 2026, 5:53 AM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 08-Sep-2026 06:55:54 CEST
Estat: en marxa usant motor
Velocitat: 0.1 kts
Direcció: 249 deg
Destinació: PALMA
Distància: 317.9 nm
Senyal RSSI: -19.3 dBFS
Vaixell AIS VesselAle

@victorribera.bsky.social Sep 8, 2026, 4:38 AM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 08-Sep-2026 05:40:48 CEST
Estat: en marxa usant motor
Velocitat: 0.1 kts
Direcció: 249 deg
Destinació: PALMA
Distància: 317.9 nm
Senyal RSSI: -19.3 dBFS
Vaixell AIS VesselAle

@victorribera.bsky.social Sep 8, 2026, 3:13 AM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 08-Sep-2026 04:15:55 CEST
Estat: en marxa usant motor
Velocitat: 0.1 kts
Direcció: 249 deg
Destinació: PALMA
Distància: 317.9 nm
Senyal RSSI: -19.3 dBFS
Vaixell AIS VesselAle

@victorribera.bsky.social Sep 8, 2026, 1:18 AM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 08-Sep-2026 02:21:44 CEST
Estat: en marxa usant motor
Velocitat: 0.1 kts
Direcció: 249 deg
Destinació: PALMA
Distància: 317.9 nm
Senyal RSSI: -19.3 dBFS
Vaixell AIS VesselAle

@victorribera.bsky.social Sep 7, 2026, 10:38 PM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 08-Sep-2026 00:14:55 CEST
Estat: en marxa usant motor
Velocitat: 0.1 kts
Direcció: 249 deg
Destinació: PALMA
Distància: 317.9 nm
Senyal RSSI: -19.3 dBFS
Vaixell AIS VesselAle

@victorribera.bsky.social Sep 6, 2026, 12:09 PM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 06-Sep-2026 13:09:20 CEST
Estat: en march amb vela vetllant
Velocitat: 9.4 kts
Direcció: 71 deg
Destinació: PALMA
Distància: 79.9 nm
Senyal RSSI: -17.5 dBFS
Vaixell AIS Vesse

@victorribera.bsky.social Sep 6, 2026, 4:08 AM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 06-Sep-2026 05:47:05 CEST
Estat: en march amb vela vetllant
Direcció: 339 deg
Destinació: PALMA
Distància: 71.9 nm
Senyal RSSI: -19.5 dBFS
Vaixell AIS VesselAlert © kx1t

@victorribera.bsky.social Sep 6, 2026, 3:11 AM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 06-Sep-2026 05:11:31 CEST
Estat: en march amb vela vetllant
Velocitat: 0.1 kts
Direcció: 339 deg
Destinació: PALMA
Distància: 71.9 nm
Senyal RSSI: -16.9 dBFS
Vaixell AIS Vess

@victorribera.bsky.social Sep 5, 2026, 5:58 PM

VesselAlert Vaixell
Nom del Vaixell: SWAGGER
MMSI: 232048122
Indicatiu: MAVM4
Tipus: Veler
Bandera: United Kingdom
Vist a: 05-Sep-2026 19:54:24 CEST
Estat: en march amb vela vetllant
Direcció: 339 deg
Destinació: PALMA
Distància: 71.9 nm
Senyal RSSI: -19.8 dBFS
Vaixell AIS VesselAlert © kx1t