Opaque URIs, URI discovery, and hypermedia

All URIs must be considered opaque values; clients should not have to construct URIs by concatenating substrings.

All URIs must be recursively discovered from:
  • The API entry-point URI, as defined in the SMC API configuration
  • Top-level service URIs
  • The top-level lists of elements
  • Links to other resources that are mentioned in these elements
  • The action links identified by the verbs (for example, upload) that are mentioned in these elements

Some URIs support or mandate the use of additional query parameters, for example, for filtering purposes.