Openapi spec for DSP

[sesa442190]

Hi,

Is openapi spec file maintained for DSP anywhere which I can refer to? Openapi spec file will help us greatly to proxy the endpoint behind gateway technology.

Thank you for your help.

[arnoweiss]

That currently doesn't exist and I don't think it should. The advantage with json schema is that each payload can be evaluated based on a single file by hand and in code. Also, implementations and individual Dataspaces still make ablot of design decisions where the protocol leaves flexibility.

As I understand, you're looking to configure an API Gateway proxying the DSP communcation to a connector. Often the implementations provide openAPI files for their APIs - sometimes even for those not intended for direct consumption like the DSP APIs.

[rokf]

We use OpenAPI specifications extensively for boilerplate code generation for both clients and servers using various tools such as https://ogen.dev/ and https://github.com/oapi-codegen/oapi-codegen. One or more OpenAPI specifications for the various HTTP bindings would definitely come in handy 👍