search

APIs-guru / openapi-directory

🌐 Wikipedia for Web APIs. Directory of REST API definitions in OpenAPI 2.0/3.x format
https://apis.guru/
Creative Commons Zero v1.0 Universal
3.84k stars 575 forks source link

Looking maintainer for GitHub API #68

Closed IvanGoncharov closed 6 years ago

IvanGoncharov commented 8 years ago

I used an official RAML spec as source: https://github.com/raml-apis/GitHub/tree/production It has many problems including #67 and many more other issues that you can easily spot. But most important is that Mulesoft(owner of repo) ignores issues and PRs.

IMHO, correct way to handle this situation is to split Swagger spec for Github API into a separate repo and maintain it there for APIs.guru to use it as a source.

Is someone interested in maintaining such repo under his user account?

MikeRalphson commented 8 years ago

@IvanGoncharov I am interested in producing a spec for the new github GraphQL API and perhaps for a 'classic' v4 if they produce one, but probably not to revise the current API v3 specification.

MikeRalphson commented 8 years ago

First cut - valid and working with bearer auth

IvanGoncharov commented 8 years ago

@MikeRalphson Great, it's Wikipedia for APIs so it's cool that you contributing specs that you are working on.

IMHO, you can produce quality spec only if you interested in studying API or interested in using OpenAPI spec.