API Entry point

As a REST API, the entry point allows navigation to other resources.

{
    "@context": "https://dlcs.github.io/vocab/context/future.json",
    "@id": "https://api.dlc.services",
    "@type": "vocab:EntryPoint",
    "customers": "https://api.dlc.services/customers",
    "originStrategies": "https://api.dlc.services/originStrategies",
    "storagePolicies": "https://api.dlc.services/storagePolicies",
    "deliveryChannelPolicies": "https://api.dlc.services/deliveryChannelPolicies",
    "queue": "https://api.dlc.services/queue"
}

This EntryPoint resource is like the API home page, and has the following properties:

customers

A link to a paged Collection of all Customers in the API instance. This is only useful for navigation to your own Customer resource: while the endpoint provides a list of Customer URIs, they don't have any information (not even a name) and you can only further navigate into your own.

domain	range	readonly	writeonly
vocab:EntryPoint	🔗 hydra:Collection (of vocab:Customer)	True	False

HTTP operations

Method	Label	Expects	Returns	Status
GET	Retrieves all customers	-	hydra:Collection	200 OK

For example, a GET on the customers URI might return:

{
    "@context": "https://dlcs.github.io/vocab/context/future.json",
    "@id": "https://api.dlc.services/customers",
    "@type": "Collection",
    "totalItems": 4,
    "pageSize": 100,
    "member": [
        {
            "@id": "https://api.dlc.services/customers/1",
            "@type": "vocab:Customer"
        },
        {
            "@id": "https://api.dlc.services/customers/2",
            "@type": "vocab:Customer"
        },
        {
            "@id": "https://api.dlc.services/customers/3",
            "@type": "vocab:Customer"
        },
        {
            "@id": "https://api.dlc.services/customers/4",
            "@type": "vocab:Customer"
        }
    ]
}

These are only useful as navigation properties to an individual Customer, and you are only permitted to see your own Customer resource.

originStrategies

A link to a paged Collection of origin strategies. These are used when constructing Customer Origin Strategies to assist the platform in fetching assets from your repositories.

See Origin strategies for a discussion.

domain	range	readonly	writeonly
vocab:EntryPoint	🔗 hydra:Collection (of vocab:OriginStrategy)	True	False

HTTP operations

Method	Label	Expects	Returns	Status
GET	Retrieves global origin strategies	-	hydra:Collection	200 OK

storagePolicies

A link to a paged Collection of global storage policies. These represent pre-canned limits that your account might be assigned. You do not need to interact with these resources. See Storage for more information.

domain	range	readonly	writeonly
vocab:EntryPoint	🔗 hydra:Collection (of vocab:StoragePolicy)	True	False

HTTP operations

Method	Label	Expects	Returns	Status
GET	Retrieves global storage policies	-	hydra:Collection	200 OK

DELETE deliveryChannelPolicies

⚠️

Do we actually need this global set? How would you refer to it?

You get some default Delivery Channel Policies when your customer is created. For thumbs and AV.

You can also refer to "hardcoded" but not dereferenceable policies use-original, none and default.

So what would be in here? DELETE

A link to a paged Collection of further collections of delivery channel policies. This is a rare example of a Collection of Collections, where the returned collections are like sub-folders, for organisational use.

These Delivery Channel policies are common settings you can re-use for your own assets, as further explained in Delivery Channels.

domain	range	readonly	writeonly
vocab:EntryPoint	🔗 hydra:Collection (of hydra:Collection)	True	False

HTTP operations

Method	Label	Expects	Returns	Status
GET	Retrieves collections of delivery channel policies	-	hydra:Collection	200 OK

queue

The most common mechanism for adding new assets to the platform is to post batches of assets to your dedicated customer queue. The entry point also provides a link to this global queue, to report on the current workload of the platform.

domain	range	readonly	writeonly
vocab:EntryPoint	🔗 vocab:QueueSummary	True	False

HTTP operations

Method	Label	Expects	Returns	Status
GET	A read-only view of how busy the platform as a whole is	-	vocab:QueueSummary	200 OK

See Queues for more.

touched 2025-09-23T12:04:54

Hydra Collections Customer