Git Product home page Git Product logo

Comments (5)

aerfio avatar aerfio commented on July 20, 2024 1

No problem 😃

from spec.

fmvilas avatar fmvilas commented on July 20, 2024

Thanks for raising the issue @chris3081.

I guess the debate here is if we should standardize operationId. My bet is that we should do it in order to increase compatibility with OpenAPI 3. However, it's not that simple in AsyncAPI because there's no such thing as an "operation object". The publish/subscribe operations are, in fact, message objects. So adding operationId as an attribute of "message" would couple messages to operations, 1:1, and that's an architecture decision the spec should not be imposing.

That said, we can rework the spec in the next major version to have operation objects separate from messages. Something like the following:

publish:
  operationId: sayHello
  summary: Says hello.
  description: Publish a message to say hello.
  message:
   summary: A hello message
   payload:
     type: object
     properties:
       arga:
         type: string
       argb:
         type: string

This would be more similar to OpenAPI 3. But, just to make it clear, this should be done in a next major version as it's a breaking change. In the meantime, your solution looks good enough to bypass the limitation.

from spec.

aerfio avatar aerfio commented on July 20, 2024

@fmvilas are you sure the assignment is right? 😛

from spec.

fmvilas avatar fmvilas commented on July 20, 2024

Aren't you going to work on this? :trollface: Sorry lad, fixing it now.

from spec.

asyncapi-bot avatar asyncapi-bot commented on July 20, 2024

🎉 This issue has been resolved in version 1.0.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

from spec.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.