Read typeTwoResource relationship

GET 
/resources/typeTwoResources/:id/relationships/:related_field/

Read a typeOneResource associated with the typeTwoResource.

Authorization Action:

resource:typeOneResources:get

Request

Path Parameters

id stringrequired

Globally unique ids (UUID4)

related_field stringrequired

Query Parameters

include string
List of included related resources.
Usage:
Including nested relationships is currently not supported.
include=related-resource0,related-resource1,...,related-resourceN
Authorization Action:
The user must be authorized to include the requested resource.
resource:<related-resource>:list
fields string
Sparse fieldsets.
Usage:
fields[resource-name]=field0,field1,...,fieldN

Responses

200

application/vnd.api+json

Schema

Schema

data objectrequired
oneOf
relationshipToMany
Array [
type typerequired
The type member is used to describe resource objects that share common attributes and relationships.
id idrequired
Each resource object’s type and id pair MUST identify a single, unique resource.
meta object
property name* any
]
included object[]
Array [
type typerequired
The type member is used to describe resource objects that share common attributes and relationships.
id idrequired
Each resource object’s type and id pair MUST identify a single, unique resource.
attributes object
relationships object
links object
oneOf
title
meta object
property name* any
]
links object
first object
oneOf
MOD1
string uri-reference
last object
oneOf
MOD1
string uri-reference
prev object
oneOf
MOD1
string uri-reference
next object
oneOf
MOD1
string uri-reference
oneOf
title
jsonapi object
The server's implementation
version string
meta object
property name* any

Example (from schema)

{
  "data": {},
  "included": [
    {
      "type": "string",
      "id": "string",
      "attributes": {},
      "relationships": {},
      "links": {},
      "meta": {}
    }
  ],
  "links": {
    "first": "string",
    "last": "string",
    "prev": "string",
    "next": "string"
  },
  "jsonapi": {
    "version": "string",
    "meta": {}
  }
}

401

not authorized

application/vnd.api+json

Schema

Schema

errors object[]required
Array [
id string
status string
links object
oneOf
title
code string
title string
detail string
source object
pointer string
A JSON Pointer to the associated entity in the request document [e.g. /data for a primary data object, or /data/attributes/title for a specific attribute.
parameter string
A string indicating which query parameter caused the error.
meta object
property name* any
]
meta object
property name* any
jsonapi object
The server's implementation
version string
meta object
property name* any
links object
oneOf
title

Example (from schema)

{
  "errors": [
    {
      "id": "string",
      "status": "string",
      "links": {},
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string",
        "meta": {}
      }
    }
  ],
  "meta": {},
  "jsonapi": {
    "version": "string",
    "meta": {}
  },
  "links": {}
}

404

not found

application/vnd.api+json

Schema

Schema

errors object[]required
Array [
id string
status string
links object
oneOf
title
code string
title string
detail string
source object
pointer string
A JSON Pointer to the associated entity in the request document [e.g. /data for a primary data object, or /data/attributes/title for a specific attribute.
parameter string
A string indicating which query parameter caused the error.
meta object
property name* any
]
meta object
property name* any
jsonapi object
The server's implementation
version string
meta object
property name* any
links object
oneOf
title

Example (from schema)

{
  "errors": [
    {
      "id": "string",
      "status": "string",
      "links": {},
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string",
        "meta": {}
      }
    }
  ],
  "meta": {},
  "jsonapi": {
    "version": "string",
    "meta": {}
  },
  "links": {}
}

Loading...