How does it discover resources?

[gr0uch]

It would be nice if resources are discoverable from the base URL, otherwise the user might have to manually enter routes:
json-api/json-api#126

[steveklabnik]

Wouldn't they already enter a base URL? I am confused.

[gr0uch]

Sorry, I meant routes to resources. If the goal here is to be able to introspect an API with only the base URL as a starting point, then the index route should include links to resources, right?

[steveklabnik]

Right. Why wouldn't those be included?

—
Sent from Mailbox for iPhone

On Wed, Dec 4, 2013 at 8:47 PM, Dali Zheng notifications@github.com
wrote:

Sorry, I meant routes to resources. If the goal here is to be able to introspect an API with only the base URL as a starting point, then the index route should include links to resources, right?

Reply to this email directly or view it on GitHub:
#1 (comment)

[gr0uch]

Because it's not yet part of the JSON API spec? :3

[steveklabnik]

Sorry, we must have some sort of serious misunderstanding here. Let's wait until I get some more code written.

—
Sent from Mailbox for iPhone

On Wed, Dec 4, 2013 at 8:59 PM, Dali Zheng notifications@github.com
wrote:

Because it's not yet part of the JSON API spec? :3

Reply to this email directly or view it on GitHub:
#1 (comment)

[diosney]

@steveklabnik What I think @daliwali ment is that the spec have to provide means to enable entire API discoverability starting at the root/index/home URL, ex: http://api.example.com/, if it wants to fulfill the hypermedia constrain and thus become an hypermedia API.

I think that by solving #126 this can be achieved since the specs already provides means to relate to other resources through the links attribute.