apis-guru / openapi-directory Goto Github PK

Hi, @IvanGoncharov, I found that Trello's API uses OAuth 1 authentication. The spec says is type oauth2

Hi Ivan, another API spec for you if it meets your criteria.

https://raw.githubusercontent.com/Mermade/open_api_specifications/master/APIMATIC%20API%20Transformer/swagger.json

It is particularly interesting as it exposes an API which can convert several API spec formats to Swagger, including Postman collections.

Mike

PS the other specs in this repository I'm still working on.

It would be cool to provide user directly link to API key registration or at least documentation that explains how to get API key. I created x-apiClientRegistration extension and mark couple or APIs.

I need help with the rest of APIs, the task is very simple just add x-apiClientRegistration into appropritate patch.yaml and submit PR. Here is example.

https://github.com/domchristie/to-markdown

HTML tends to show up in api.info.description, parameter.description, etc

Initial list is:

• service name x-serviceName
• Link to page where you can read how to receive API key, 'x-getApiKey'
• URL on logo, x-logo
• Categories tags
• Link to original spec, x-origin(Format, FormatVersion, URL)
• Provider name x-providerName, suggested by @bobby-brennan

https://github.com/raml-apis looks like interesting collection

I can see few imported already: https://github.com/APIs-guru/api-models/search?utf8=%E2%9C%93&q=raml-apis

When I click in the link I have a 404 error.

https://apis-guru.github.io/api-models/

for example

https://apis-guru.github.io/api-models/audiosear.ch/1.0.0/1

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

e.g. GET /activities requires all these scopes:

        - 'https://www.googleapis.com/auth/youtube'
        - 'https://www.googleapis.com/auth/youtube.force-ssl'
        - 'https://www.googleapis.com/auth/youtube.readonly'

Maybe it's meant to be an OR rather than an AND?

This API makes you sign up through Mashape, can't call the API without it.

http://www.pollencheck.eu/docs/

From the description:
For all calls, supply your API key. Sign up to obtain the key.

Our API supports both unencrypted (HTTP) and encrypted (HTTPS) protocols. However, for security reasons, we strongly encourage using only the encrypted version.

The API key should be supplied as either a request parameter user_key or in Authorization header.

Try to download logo and check that status is 200

Oracle Cloud have api catalog and you can get Swagger files here:
https://apicatalog.oraclecloud.com/v1/services/

Problem is that some of the APIs missing host property so they resolved to apicatalog.oraclecloud.com. I don't know if multiple instances of Oracle Cloud exist and host was omitted on purpose? Or it simple mistake?

You can help me by researching this and provide correct values for hosts.

• is actually list of Swagger 2.0 APIs http://epscass.prd-prsn.com/api/institution for example http://eps.openclass.com/india/api/
• on the other hand: OpenClass will retire on January 1, 2018 pasted from http://www.pearsonhighered.com/openclass/
• this page should contain list of their API stack but it is hacked: http://code.pearson.com/open-class

Test according to https://github.com/APIs-guru/api-models/blob/master/API.md
Basically, test content of this file https://apis-guru.github.io/api-models/api/v1/list.json
Preferably implemented as JSON Schema validation, JSON Schema could be extracted from here:
https://github.com/APIs-guru/api-models/blob/master/scripts/apis_guru_swagger.yaml

If you want to help write here and I will provide more details.

e.g. Trello and noun project

Suggested by @sanchojaf on Gitter:

we know OAuth 1.0 is not supported by Swagger 2.0, is possible and make sense add to patch.yaml ?

Why you converted all schemas in YAML format ?
Could you provide samples in both formats (JSON and YAML)?

sendgrid.com v3.0 schema
https://apis-guru.github.io/api-models/sendgrid.com/3.0/swagger.json

has path /categories/stats/sums with very strange response type

            "schema": {
              "properties": {
                "": {
                  "$ref": "#/definitions/category_stats"
                }
              },
              "type": "object"
            }

It is object with empty name property of type #/definitions/category_stats
I believe that this is incorrect type definition // @IvanGoncharov

Hi Ivan,

As we discussed, I would like to see a Swagger file for your REST API. I would then be able to import it into Ritc.

Regards

Colin Goldberg

Currently this page http://apis-guru.github.io/api-models/ returns 404 errer. It would be great if it had list of links to all the modles in this repo

Things to note that I don't update API if it doesn't pass validation.
And sometimes it not so easy to fix such mistake so it can take me some time to update such APIs.

Currently, I stuck with:

• daisycon.com,
• wikimedia.org
• uploady.com.

Continue discussions from #36:

@darosh:

Regarding logos and hub:

• they have various size, ratio and quality and in my opinion they would need some preprocessing not to be scaled in browser and perhaps merging into single CSS sprite image might be a good idea too
• Google Books logo is outdated for example
• hub.html
  • has no final design but I will probably prefer to keep it simple without logos, using the 🌈 generator based on logo colors,
  • right now I just need the links to the Swagger UI I work on, maybe later I will change the cards into something expandable showing more metadata you provide in the list.json including logos...

According to http://online.swagger.io/validator

• http://online.swagger.io/validator/debug?url=https://apis-guru.github.io/api-models/trello.com/1.0/swagger.json
• http://online.swagger.io/validator/debug?url=https://apis-guru.github.io/api-models/googleapis.com/storagetransfer/v1/swagger.json
• http://online.swagger.io/validator/debug?url=https://apis-guru.github.io/api-models/watchful.li/1.0.0/swagger.json
• http://online.swagger.io/validator/debug?url=https://apis-guru.github.io/api-models/plenigo.com/2.0.0/swagger.json
• http://online.swagger.io/validator/debug?url=https://apis-guru.github.io/api-models/reactome.org/1.0/swagger.json
• http://online.swagger.io/validator/debug?url=https://apis-guru.github.io/api-models/bbryiot.com/1.0.0/swagger.json

Trello has malformed url: "authorizationUrl": "https:\\/\\/trello.com\\/1\\/appKey\\/generate",

https://raw.githubusercontent.com/Mermade/bbcparse/master/nitroApi/swagger.json

Automatically generated from API's metadata feed

From the info section:

    "version": "1.0.0",
    "title": "BBC Nitro API",
    "description": "BBC Nitro is the BBC's application programming interface (API) for BBC Programmes Metadata.",
    "termsOfService": "http://www.bbc.co.uk/terms/",
    "contact": {
        "name": "Open Nitro Project",
        "email": "[email protected]",
        "url": "http://developer.bbc.co.uk/"
    },
    "license": {
        "name": "Nitro Public License",
        "url": "https://developer.bbc.co.uk/nitropubliclicence/"
    }

It's very easy to add some OpenAPI extension like x-categories.
But in order to tag every API a lot of manual work required.
If someone volunteers to do this work I can provide instruction and write all necessary code.

Hi,

I've got a simple service to collect and analyze HTTP requests which is useful for QA and testing purposes (write automated tests for web-hook, HTTP redirects and notifications, or even to test REST clients). Something similar to http://requestb.in but entirely open source.

The Request Baskets service is running at https://rbaskets.in but can be deployed by anybody for it is an open source project: https://github.com/darklynx/request-baskets

The RESTful API is documented in Swagger (OpenAPI) format and can be found here: https://github.com/darklynx/request-baskets/blob/master/doc/api-swagger.yaml

It would be great to see my API in your collection!
Thanks

The early preview release of the Figure.NZ API has been retired.
Our intention is to release a new API before the end of 2016,
but this depends on other platform features and we do not have a firm release date at this time.

Pasted from https://figure.nz/api/

The scripts folder is a bit confusing. Because it is located at the same level as APIs folders it seems like there is an API with the name scripts.
It would be more logical to move APIs into some subfolder.

There are some APIs without security definitions and actually they needed. Here is the list:
Requires API key:

• Zoom Connect
• Watchful.li
• Versioneye
• Spectrocoin
• Peel Tune
• Gennea
• Statsocial

Requires OAuth 2.0:

• Uploady

Basic authentication:

• Geodesystems

Others:

• Discovery Market Research
• Glugbot
• Datumbox
• Daisycon
• Clarify
• Blackberry
• Beanstream
• Infermedica

#1 is severely outdated and should be replaced with normal documentation.

"accessCode" should be "implicit"

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

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

I have technical possibility to add Watson APIs from this list:
https://watson-api-explorer.mybluemix.net/

But according to this comment:

Part of the reason why json files are not explicitly exposed is that the json we use has some customization for use in the API explorer, and so are not completely accurate representations of the services themselves, and don't contain the base path, or support schemes, or authentication to match the service. You should be careful about using the Swagger definitions automatically for anything other than the API explorer they're supporting.

I don't have enough time to check the documentation for each API and make necessary corrections.
But if somebody willing to do this work, I will add them.

https://github.com/APIs-guru/api-models/tree/master/APIs/data2crm.com

See x-origin: http://api.data2crm.com/docs/ref/get-swagger-v2

PollenCheck announced:
"I regret to inform everyone that all PollenCheck services will be fully retired after a 1-month period ending on March 15, 2016....
PollenCheck public API will not be accessible after March 14, 2016.
PollenCheck API is deprecated. Do not use it longer."

Github is nice but UX in this case is not the ideal IMHO. I did experimental listing of APIs with jQuery. Not fully implemented or too fancy, contains bugs and error handling etc but something like this would make browsing and discoverability a little better.

http://apisuomi.fi:8080/apis/apis.guru/

If such (average) human readable front is created, it might make sense to use some lightweight JS framework.

APIs with API_Keys parameters in their paths, but not defined in security definitions:

1- transportation_laws_and_incentives_0_1_0

2- high_performance_building_database_1_0

3- owler_1_0_0

4- org_hunter_1_0_0

5- ontraport_1_1_3

6- yunbi

7- vat api

8 - Pandorabots

9- regulations_gov_3_0

10- i_am_real_1_0_0

11- hetras hotel API v0 v0

12- hetras_booking_api_v0_v0

13- getty_images_3_0

14- gavagai_1_0_0

15- data2_crm_api_documentation_1_0_0

16- core_api_v2_beta_2_0

17- city_context_1_0_0

18- active_documentation_for__v1_1_1_7

And another public BBC API.

https://raw.githubusercontent.com/Mermade/bbcparse/master/iblApi/swagger.json

This one has an automatically generated response model derived from the official JSON schema. The BBC Nitro spec will have its response format documented soon too, as I have managed to programmatically convert the official XML Schema to JSON schema.

Mike

Would like to sort by newest and lastUpdated

https://developers.google.com/admin-sdk/directory/

All google APIs missing upload functionality.
Main problem is such calls using '/upload' prefix to basePath.
Reported by @shaharsol

Looks like specification has gone through re-branding recently, and now it is OpenAPI. It also has a new web-site now: https://openapis.org/

The link to https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md and naming "Swagger API", etc. should be updated in README

Should be able to search title/tags/description with a query term.

I'd like to use PUT /orgs/:org/memberships/:username in the github API but think it's missing from the swagger file.

ExaVault has GET only API (GET method for creating and deleting!) but they mention they provide "safer" POST alternative methods undocumented in swagger.

https://www.exavault.com/developer/api-docs/

ExaVault supports both POST (recommended when requesting large data sets)
and GET operations, and requires an API key in order to use.

It is pretty important information.

External docs and/or description patch could help.

Note: GET only approach + server side + user with WGET tool is a recipe for disaster. 😃

We have Uber and Instagram as examples over Swagger Editor example files. Instagram is not complete yet, I'm working on it. If you want to have those feel free to steal them from there

Just FYI, it doesn't look like this API is being supported anymore (it is Pearson's OpenClass API - http://code.pearson.com/openclass).