#GlueCon 2014 Notes: APIs.json and API Discovery on the Web – Steven Willmott and Kin Lane

APIs.json and API Discovery on the Web – Steven Willmott and Kin Lane

• APIs.json is the equivalent of a robots.txt or sitemap.xml files for web APIs
• The goal is to provide additional community support to supplement ProgrammableWeb’s API directory that is dependent on manual curation
• APIs.json can be provided either by the API provider on the same domain (authoritative) or by the community (non-authoritative) – http://apisjson.org
• APIs.io is a place to index what it out there – http://apis.io
• No JSON schema for APIs.json yet, but coming soon
• APIs.io has a meta-API, allowing you to search and browse the directory listings
• Provides linking to Swagger definition, allowing for easy discovery and dynamic client generation