#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