APIs.guru is a platform that aims to serve as a Wikipedia for web APIs by providing documentation for APIs in one centralized location. It filters out private and unreliable APIs, standardizes documentation into the Swagger 2.0 format, and allows contributors to add and improve API descriptions. APIs.guru also seeks to address challenges of data and schema incompatibility between APIs by developing a system of common scalar and complex data types that can be referenced and converted between APIs.

1. APIs.guru
APIs.guru
Wikipedia for APIWikipedia for Web APIs

2. Developer-driven adoption

3. iPaaS

4. Consumer products

5. Give me more API!

6. Hold a minute … or month

7. API growth

8. 2 days 1 days 3 days 3 days
Standard approach

9. Human-readable docs
Method
characteristics
Arguments
Response
description
Method
Method description
required?
Argument type
Response type
Response description
Response description

10. Machine-readable docs
API version
Supported protocols
Method
Method
description
Link to response
description
required?
Argument type
API
characteristics
Method
characteristics
Response
Arguments

11. Would it be nice?
All APIs descriptions in one place
Documented in one format
Anyone can add/improve API description

12. What APIs.guru do?
Filter out private and non-reliable APIs.
Convert different formats into Swagger 2.0
Fix mistakes, ~80% of spec have them
Add additional data, like: logo, categories, …

13. Contribution process
Review
Validation script
API owner
Pull requests
Contributors
API

14. Any-API.com

15. SDKs.io

16. CenitSaaS.com

17. commandcar

18. DataFire.io

19. Why not Hypermedia?
Cool technology, but doesn’t help iPaaS:
Can access metadata only after first call
Metadata only for particular entities
Require API owner to change implementation

20. Far Far Future: Synergy

21. Data incompatibility
{
“First name”: “John”,
“Surname”: “Smith”
}
{
“Name”: “John”,
“Surname”: “Smith”
}
{
“Full name”: “John Smith”
}

22. Schema incompatibility
{
“properties”: {
“First name”: {
“type”: “string”
},
“Surname”: {
“type”: “string”
}
}
}
{
“properties”: {
“Name”: {
“type”: “string”
},
“Surname”: {
“type”: “string”
}
}
}{
“properties”: {
“Full name”: {
“type”: “string”
}
}
}

23. Stage 1: Scalar types
{
“properties”: {
“First name”: {
“type”: “string”
}
“Surname”: {
“type”: “string”
}
}
}
{
“properties”: {
“First name”: {
“$ref”: “http://apis.guru/types/name#”
}
“Surname”: {
“$ref”: “http://apis.guru/types/surname#”
}
}
}

24. Stage 2: Complex types
{
“properties”: {
“First name”: {
“$ref”: “http://apis.guru/types/name#”
},
“Surname”: {
“$ref”: “http://apis.guru/types/surname#”
}
}
}
{
“$ref”: “http://apis.guru/types/fullname/15#”
}

25. Stage 3: type converters
function (data) {
return {
“Full name”: data[“First name”] + data[“Surname”]
};
}
{
“First name”: “John”
“Surname”: “Smith”
}
{
“Full name”: “John Smith”
}

26. APIs.guruJoin the movement
APIs.guru
ivan.goncharov.ua@gmail.com ivangon4arovhttps://github.com/APIs-guru/api-models
@APIs_guru