Compound document param strategy

1

For compound documents. Lets say I wanted to include actors, agency and state in the GET /movies endpoint. Should it be:

/movies?include=actors.agency.state

Or

/movies?include=actors,actors.agency,actors.agency.state
2

The first option should be enough.

From the spec:

Note: Because compound documents require full linkage (except when relationship linkage is excluded by sparse fieldsets), intermediate resources in a multi-part path must be returned along with the leaf nodes. For example, a response to a request for comments.author should include comments as well as the author of each of those comments.

https://jsonapi.org/format/#fetching-includes