apis-guru / unofficial_openapi_specs Goto Github PK

Moving to relevant repo.

@bobby-brennan wrote:

Every "list" operation should have a page parameter

How close is the scrape-to-swagger version of GitHub v3 to being usable as a replacement?

See the postman collection here:

https://www.getpostman.com/api/collections/a54dde1fd81323f2203e

Moving issue to relevant repo.

@bobby-brennan wrote

Would suggest moving the Trello spec to unofficial-api-specs as the original doesn't seem to be maintained. If you do I'll submit a PR there.
OAuth2 definition should be removed as Trello only supports OAuth1
api_key name should be key
should also have api_token as both key and token are needed
Correct secDefs:

{
  "securityDefinitions": {
    "api_key": {
      "in": "header",
      "name": "key",
      "type": "apiKey"
    },
    "api_token": {
      "type": "apiKey",
      "in": "query",
      "name": "token"
    }
  }
}

The file in this repository (current master) is at:
https://github.com/APIs-guru/unofficial_openapi_specs/blob/4c18c8f00279ffecb90c1439da0a1d8b8dc090b1/trello.com/1.0/swagger.yaml

it seems to be out of date with the version published at https://api.apis.guru/v2/specs/trello.com/1.0/openapi.yaml

Also, I see that trello/atlassian have posted this in their docs: https://developer.atlassian.com/cloud/trello/swagger.v3.json

Is this the same? Should we update the source in this github repo?

Back-ref to the discussion that brought me here on the Trello dev discourse: https://community.developer.atlassian.com/t/machine-readable-description-of-rest-api

https://bitbucket.org/pstreule/hc-swagger-gen

From @bobby-brennan on April 26, 2016 23:37

https://github.com/APIs-guru/api-models/blob/master/APIs/github.com/v3/swagger.yaml#L13572

Listed as string, should be a user object, e.g. here:
https://api.github.com/repos/bobby-brennan/rss-parser/issues/3

Copied from original issue: APIs-guru/openapi-directory#67

From @bobby-brennan on July 2, 2015 15:22

I'd like to be able to show only free or only paid APIs

Copied from original issue: APIs-guru/openapi-directory#6

Was intending to use the swagger file for C# net core app.
Absence of return types in file makes it kinda useless for strongly typed languages without reviewing the whole file. =c
Might work on this myself someday, for now using https://github.com/gregsdennis/Manatee.Trello

e.g.

  /batch:
    get:
      operationId: getBatch
      parameters:
        - default: undefined
          description: 'list of API v1 GET routes, not including the version prefix'
          in: query
          name: urls
          required: true
          type: string

From @bobby-brennan on January 29, 2016 22:20

"accessCode" should be "implicit"

accessCode (I think) means the token is passed via Authorization: Bearer header
but buffer wants it as ?access_token=

Copied from original issue: APIs-guru/openapi-directory#34