apis-guru / openapi-directory Goto Github PK
View Code? Open in Web Editor NEW๐ Wikipedia for Web APIs. Directory of REST API definitions in OpenAPI 2.0/3.x format
Home Page: https://apis.guru/
License: Creative Commons Zero v1.0 Universal
๐ Wikipedia for Web APIs. Directory of REST API definitions in OpenAPI 2.0/3.x format
Home Page: https://apis.guru/
License: Creative Commons Zero v1.0 Universal
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.
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.
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
?
Continue discussions from #36:
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...
This API makes you sign up through Mashape, can't call the API without it.
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
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
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
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.
Try to download logo and check that status is 200
According to http://online.swagger.io/validator
Trello has malformed url: "authorizationUrl": "https:\\/\\/trello.com\\/1\\/appKey\\/generate",
Should be able to search title/tags/description with a query term.
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
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
e.g. Trello and noun project
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. ๐
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
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
Hi Ivan, another API spec for you if it meets your criteria.
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.
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
I'd like to be able to show only free or only paid APIs
Hi, @IvanGoncharov, I found that Trello's API uses OAuth 1 authentication. The spec says is type oauth2
#1 is severely outdated and should be replaced with normal documentation.
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.
All google APIs missing upload functionality.
Main problem is such calls using '/upload' prefix to basePath
.
Reported by @shaharsol
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
Would like to sort by newest and lastUpdated
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 host
s.
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
.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."
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.
"accessCode" should be "implicit"
accessCode (I think) means the token is passed via Authorization: Bearer header
but buffer wants it as ?access_token=
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.
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?
Just FYI, it doesn't look like this API is being supported anymore (it is Pearson's OpenClass API - http://code.pearson.com/openclass).
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.
I'd like to use PUT /orgs/:org/memberships/:username
in the github API but think it's missing from the swagger file.
Initial list is:
x-serviceName
x-logo
x-origin
(Format, FormatVersion, URL)x-providerName
, suggested by @bobby-brennanhttps://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/"
}
Why you converted all schemas in YAML format ?
Could you provide samples in both formats (JSON and YAML)?
There are some APIs without security definitions and actually they needed. Here is the list:
Requires API key:
Requires OAuth 2.0:
Basic authentication:
Others:
https://github.com/domchristie/to-markdown
HTML tends to show up in api.info.description, parameter.description, etc
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.