Resources affording other resources actions (linking)

Given this blueprint (currently valid syntax): 

``` apib
# Author [/author/{id}]
- Parameters
    - id (number) - Id of the author
- Attributes
    - email (string) - Email of the author

## Retrieve Author [GET]
- Relation: self
- Response 200 (application/json)   
    - Attributes (Author)
```

I want to be able express that another resource affords the "Retrieve Author" action without the need to duplicate the "Retrieve Author". 

For example like this:

``` apib
# Blog Post [/blogpost/{id}]
- Parameters
    - id (number) - Id of the Blog Post
- Attributes
    - content (string) - Content of the Blog Post

## Retrieve [GET]
- Relation: self
- Response 200 (application/json)   
    - Attributes (Blog Post)

## Action Retrieve Gist Author 
- Relation: author (Author[self])
```

This enables linking of the resources and hence HATEOAS description.

To be addressed in [draft APIB RFC](https://github.com/apiaryio/api-blueprint-rfcs/pull/2)


Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Resources affording other resources actions (linking) #288

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Resources affording other resources actions (linking) #288

Description

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions