Hands-On RESTful API Design Patterns and Best Practices
by Harihara Subramanian J, Anupama Murali, Pethuru Raj
Discoverability
As we have discussed in the earlier chapter, API developers are the raison d'être of APIs. Helping them find the right APIs and helping them figure out programmatically whether the site that's being accessed has an API enabled or not will be the most critical responsibility of the API.
The primary step to connect with a site is to find out if the site is API enabled by simple URLs that are be using as user input to help us verify the API's availability. They also help us find out how to access them.
Discoverability of the API is all about the descriptive capability of the server to instruct the client on the usage of the API.
Let's look at the two types of discoverability in the following section and their implementation in ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access