Skip to content

fix(?): 🐛 swagger.json is highly outdated #84

@Zoriot

Description

@Zoriot

That's why also the docs at https://buildtheearth.github.io/web/api.html are outdated, which is quite bad when you want to work with it.
These routes are missing and possible more:

https://api.buildtheearth.net/api/v1/public/buildteams/{team}/applications
https://api.buildtheearth.net/api/v1/public/buildteams/{team}/applications/{app}

Also, it's currently not possible to generate a client for java with https://github.com/OpenAPITools/openapi-generator/ because there are some errors with the scheme, which i would have to manually fix elsewhere.

There were issues with the specification. The option can be disabled via validateSpec (Maven/Gradle) or --skip-validate-spec (CLI).
 | Error count: 5, Warning count: 4
Errors: 
	-attribute paths.'/buildteams/{id}/application/questions'(post).requestBody.content.'application/json'.schema.items is missing
	-paths.'/public/buildteams/{id}/members'. Declared path parameter id needs to be defined as a path parameter in path or operation level
	-attribute paths.'/buildteams/{id}/socials'(post).requestBody.content.'application/json'.schema.items is missing
	-attribute components.schemas.Error.value is unexpected
	-paths.'/public/buildteams/{team}/claims/{id}'. Declared path parameter id needs to be defined as a path parameter in path or operation level
Warnings: 
	-attribute paths.'/buildteams/{id}/application/questions'(post).requestBody.content.'application/json'.schema.items is missing
	-paths.'/public/buildteams/{id}/members'. Declared path parameter id needs to be defined as a path parameter in path or operation level
	-attribute paths.'/buildteams/{id}/socials'(post).requestBody.content.'application/json'.schema.items is missing
	-attribute components.schemas.Error.value is unexpected
	-paths.'/public/buildteams/{team}/claims/{id}'. Declared path parameter id needs to be defined as a path parameter in path or operation level

Would be great if that can be updated so it's possible to work with the api more easily. Needed for Build Team Tools and possible also other projects.

Metadata

Metadata

Assignees

No one assigned

    Labels

    wontfixThis will not be worked on

    Projects

    Status

    Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions