Bump_hq, to random
@Bump_hq@fosstodon.org avatar

With its next major update on the horizon, v4 is set to bring significant changes. @Philsturgeon has prepared a guide to review the first announced elements, so you can get a head start before the big day.

https://bump.sh/blog/openapi-v4-moonwalk?utm_source=mastodon&utm_medium=blog&utm_campaign=openapi-v4-preview https://bump.sh/blog/openapi-v4-moonwalk?utm_source=twitter&utm_medium=blog&utm_campaign=openapi-v4-preview

Bump_hq, to random
@Bump_hq@fosstodon.org avatar

With V4 Special Interest Group development making significant progress, the amazing
@Philsturgeon has prepared a summary of the major new features to come. This is to get you prepared as early as possible for all the great updates that await us.

https://t.co/zHW35FTVPH

dgoosens, to random
@dgoosens@phpc.social avatar

Man... the things those devs from @cooptilleuls manage to do with @ApiPlatform !

So happy to work with (well actually learn) with @johnkrovitch & @vincentchalamon) !!

cc @dunglas

https://api-platform.com/

somnambula, to Symfony
@somnambula@det.social avatar

@dunglas couple of days ago there was PR for 2.7.17 release of api-platform/core, which failed all tests in CI, but still was merged and broke a lot of CI/CDs including the one in my project. Literally any composer update. Any help needed?

💡api-platform/core contribution guideline:
https://github.com/api-platform/core/blob/main/CONTRIBUTING.md

🛠 github issue:
https://github.com/api-platform/core/issues/6226

Bump_hq, to random
@Bump_hq@fosstodon.org avatar

OpenAPI users are familiar with it: the Pet Store example has had its time. This definition example for getting started shows some age. We asked @Philsturgeon to prepare something more up-to-date and in line with modern best practices: introducing Train Travel, a new sample available for your tooling and testing needs.

https://bump.sh/blog/modern-openapi-petstore-replacement?utm_source=mastodon&utm_medium=blog&utm_campaign=train-travel

ninovandermark, to dotnet
@ninovandermark@fosstodon.org avatar

Just found out that it's pretty straight-forward to generate the Swagger specification for a .NET API during the build stage, as opposed to during runtime.

Props to @khalidabuhakmeh for doing a write-up of this.

Not only does it save startup time for the API, as the middleware doesn't have to "walk the endpoints" every time it starts up, but now we can do clever things with the spec like publishing or diffing it for various reasons.

https://khalidabuhakmeh.com/generate-aspnet-core-openapi-spec-at-build-time

#dotnet #openapi

orhun, to rust
@orhun@fosstodon.org avatar

Here is how you can automatically generate API documentation for your Rust service! 🏗️ 🦀

🚀 apistos: Actix-web wrapper for OpenAPI 3.0 documentation generation.

⭐ GitHub: https://github.com/netwo-io/apistos

📚 Docs: https://docs.rs/apistos

braidn, to random

How are folks writing #api s these days and getting for (mostly) free documentation?

Are we choosing things like: https://typespec.io or are we still hand building #yaml files for #openapi ?

remixtures, to random Portuguese
@remixtures@tldr.nettime.org avatar

#APIs #OpenAPI #OAI #Swagger: "There are few projects in the API space with as dedicated a following as the OpenAPI Initiative (OAI) — and for a good reason! As a specification, OpenAPI has opened the door for a standardized API definition solution that makes for better portability and extensibility, more effective lifecycle management, and better developer experience across the board.

One of the most exciting parts about OpenAPI is looking to the future to see what it will become. This was made much more exciting with an announcement in early December 2023: OpenAPI has targeted the launch of v4, codenamed “Moonwalk”, by the end of 2024!

There is a lot of buzz about just what v4 will look like. Yet, there are multiple open questions. For instance, how OpenAPI will work with AI and LLMs seems to be a big one. Below, we’re going to take a brief look into this topic and consult with some experts to get their thoughts."

https://nordicapis.com/openapi-sets-it-sights-on-v4-moonwalk-for-2024/

vincentbiret, (edited ) to random
@vincentbiret@hachyderm.io avatar

A couple of weeks ago @darrel_miller and I were invited to chat about and more on the "APIs you won't hate" podcast with @Philsturgeon

https://apisyouwonthate.com/podcast/microsoft-kiota-graph-api-darrel-miller-vincent-biret/

wyri, to php
@wyri@haxim.us avatar

Spec updates like this are "fun", makes me happy I'm fully overhauling the schema generation:

#php #oas #openapi

skolima, to microsoft
@skolima@hachyderm.io avatar

That's interesting - #Microsoft is feeling confident enough about their #OpenAPI client generator #Kiota that they are replacing the #GitHub SDK libraries for #Go and #dotnet with ones generated automatically. https://github.blog/2024-01-03-our-move-to-generated-sdks/

vincentbiret, to github
@vincentbiret@hachyderm.io avatar
smallcircles, to fediverse
@smallcircles@social.coop avatar

For the question of "Why use ?" has never been answered. There should be clear merits to wade through all the complexity that this choice brings, right?

Yes, its ultra flexible, and you can define your own semantic , and theoretically it could provide a robust extension mechanism to AP protocol. Except that right now it doesn't.

What's the vision of a Linked Data ? What great innovative would it bring, that makes it worthwhile?

smallcircles,
@smallcircles@social.coop avatar

@evan @steve @hrefna

FYI I just bumped into this kinda interesting https://datacontract.com site:

"A is a document that defines the structure, format, semantics, quality, and terms of use for exchanging data between a data provider and their consumers [..] It follows and conventions".

Philsturgeon, to random
@Philsturgeon@mastodon.green avatar

💻 I’ve been absolutely smashing paid work, API consulting, tech workshops, technical writing, for the last two months, but I need more work.

If you want me to write for you, review your API/products (internally or publicly), consult at your office anywhere in Europe, whatever, please book now for Jan/Feb!

https://philsturgeon.com/api-consulting-and-writing/

Philsturgeon,
@Philsturgeon@mastodon.green avatar

Use discount code "HAPPY2024" to knock 15% off the price of paid writing or API consulting/workshops. Book now and let's get this year off to a productive start!

Articles: https://buy.stripe.com/4gw8Ae2DB7KV1xeaEM

Consulting/Workshops: https://book.stripe.com/3csaIm5PN3uF2BifZ7

wyri, (edited ) to php
@wyri@haxim.us avatar

Rethinking configuration for my / client generator while transforming it into a package generator. Currently using hydrating into classes. Mainly looking to support both those wanting to keep it simple and those with complex setups without to much duplication.

richlv, to Kubernetes
@richlv@mastodon.social avatar

Hey / community - is https://github.com/kubernetes-client/perl/ dead?

Last meaningful commit seems to be 4 years ago.

mjgardner,

@richlv https://kubernetes.io/docs/reference/#officially-supported-client-libraries has a much shorter list of “officially supported” client libraries: , , , , , and (!). No .

https://github.com/kubernetes-client/perl is mostly generated automatically from the spec by https://openapi-generator.tech and was last done so for version 1.13.7.

The current release is v1.29. They clearly don’t even have a process to push updates to GitHub.

Seek alternatives for a Perl client.

mjgardner, (edited )

@virtuous_sloth @richlv #OpenAPI specifications can be either YAML or JSON.

Here's a (verbose) transcript of me using the openapi-generator command line via #Docker to generate a #Perl #Kubernetes client from their spec on GitHub: https://pastebin.com/2rtrNGTD

mjgardner,

@virtuous_sloth @richlv Normally you’d pull the spec from your own server's /openapi/v2 or /openapi/v3 endpoint. See https://kubernetes.io/docs/concepts/overview/kubernetes-api/#api-specification

That way you always have the correct version of the API for your particular installation.

mandrasch, to php
@mandrasch@social.tchncs.de avatar

Is there a modern "fun" way of building REST APIs in with ()? 🤓

I currently work with controller actions, models (craft / yii2) and swagger-php - and writing all of these comments and model properties seems to be a bit repetitive? Or is this just the way it is?

nono2357, to random
BishopFox, to opensource

Use the new #opensource tool Swagger Jacker to audit OpenAPI definition files, allowing you to identify potential vulnerabilities or misconfigurations in API routes defined within the definition document. Learn how it works, how it can make auditing API endpoints less tedious, and more in this tutorial from Tony West.

#OpenAPI #pentesting #offensivesecurity

https://bfx.social/47Zubyk

frankel, to random
@frankel@mastodon.top avatar
hrefna, (edited ) to random
@hrefna@hachyderm.io avatar

Okay, thinking about how to represent a #ActivityStreams in #OpenAPI some more, a few thoughts:

Q1: Why validate incoming values?

A 1.1: Per OWASP API6:2019: There are a lot of things that can go sideways very easily if you just openly accept values from the internet and write them into a database and, even to the extent this isn't a problem with the way it is written today, the extension mechanism means it might always become an issue in the future.

1/

  • All
  • Subscribed
  • Moderated
  • Favorites
  • JUstTest
  • kavyap
  • DreamBathrooms
  • thenastyranch
  • magazineikmin
  • InstantRegret
  • GTA5RPClips
  • Youngstown
  • everett
  • slotface
  • rosin
  • osvaldo12
  • mdbf
  • ngwrru68w68
  • megavids
  • cubers
  • modclub
  • normalnudes
  • tester
  • khanakhh
  • Durango
  • ethstaker
  • tacticalgear
  • Leos
  • provamag3
  • anitta
  • cisconetworking
  • lostlight
  • All magazines