DZone
Performance Zone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
  • Refcardz
  • Trend Reports
  • Webinars
  • Zones
  • |
    • Agile
    • AI
    • Big Data
    • Cloud
    • Database
    • DevOps
    • Integration
    • IoT
    • Java
    • Microservices
    • Open Source
    • Performance
    • Security
    • Web Dev
DZone > Performance Zone > APIs.Json, APIs.io and API Discovery on the Web

APIs.Json, APIs.io and API Discovery on the Web

Steven Willmott user avatar by
Steven Willmott
·
May. 27, 14 · Performance Zone · Interview
Like (0)
Save
Tweet
4.31K Views

Join the DZone community and get the full member experience.

Join For Free

We released some exciting news at the APISTRAT Gluecon Un-Workshop yesterday together with Kin Lane at API Evangelist: launching a new idea for how to promote the use of API Meta Data on the Public Web. The two things we announced were:

  • APIS.json: A new format to documenting the APIs on a given internet domain and get them found.

  • APIs.io: A simple search engine which uses the format.

In combination, the aim is to both help get more meta-data about APIs available in public and also begin making it easier to find these APIs. We’re also open-sourcing the API Search engine, so others can run their own search engines also (see APIs.io) for more information on this.

Why do this?

Web application programming interfaces (APIs) are becoming the “glue” of the Web because they indicate how software components should interact with each other. It is increasingly critical for companies to both provide APIs and consume those of others. But unlike the Web pages of the human Web, Web APIs are rarely linked together and cannot be “crawled” in the same way to build a picture of all the APIs available, and very little machine readable information is published about about them.

The current solution is to use public API directories, which do an admirable job of gathering APIs submitted to them. But such a process will be hard to to scale as the number of APIs grows rapidly.

Hopefully the new format will everybody improve API Discovery on the Web.

APIs.Json

The APIs.json format is very early and we’re definitely keen to get comments – information is available at http://apisjson.org/ and the current stable version is v0.13. We’ve also had a lot of excellent comments and plan to roll the most useful in very shortly.

APIs.Io

The search engine is available at http://apis.io/ and is intended to be a simple search engine for the format and we hope more will emerge. The service also provides:

  • A Generator for APIs.json files.
  • A Validator for APIs.json files.

The service also has a simple API which we will improve over time and you will soon be able to pull a full list of the current apis.json files being indexed so you can bootstrap your own search engine.

A shout out also to Chris Matthieu who did a great job of initially ran the APIs.io domain and service. The original APIs.io is still available at http://legacy.apis.io.

How to get involved

For discussion on the format, please join the APIs.json discussion group (address on the site above). The try out the format and get listed in the directory, head to the tools at APIs.io!

API Web Service Discovery (law)

Published at DZone with permission of Steven Willmott, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • The Most Popular Kubernetes Alternatives and Competitors
  • 5 Steps to Strengthen API Security
  • Role of Development Team in an Agile Environment
  • Unit Vs Integration Testing: What's the Difference?

Comments

Performance Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • MVB Program
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends:

DZone.com is powered by 

AnswerHub logo