Does everything in includes need to also have a relationship?

Given a tree of entities: Worlds/Continents/Countries.

When we request ./Worlds/, it would contain relationships for Continents and (optionally) include the Continents resources too.

Would you also expect the Countries resources to be included as resources too?

Countries is not a descendent of World but is a descendent of Continents.

Thank you!

This would be the recommendation:

/worlds/

Returns the worlds without related resources (just relationships objects for each resource)

/worlds?include=continents

Returns the worlds with continents as a compound document ( data + included member )

/worlds?include=continents.countries

Returns the worlds with countries and intermediate continents, this is full linkage.

See inclusion of related resources

2 Likes