Example

http://dlcs.azurewebsites.net/customers/4

Customer

A customer represents you, the API user. You only have access to one customer, so it is your effective entry point for the API. The only interation you can have with your Customer resource directly is updating the display name, but it provides links (🔗) tocollections of all the other resources.

/customers/{0}

Supported operations

Method Label Expects Returns Statuses
GET Retrieve a Customer vocab:Customer 200 OK, 404 Not found

Supported properties

name

The URL-friendly name of the customer

domain range readonly writeonly
vocab:Customer xsd:string False False

displayName

The display name of the customer

domain range readonly writeonly
vocab:Customer xsd:string False False

portalUsers (🔗)

Collection of user accounts that can log into the portal. Use this to grant access to others in your organisation

domain range readonly writeonly
vocab:Customer hydra:Collection True False
/customers/{0}/portalUsers
Method Label Expects Returns Statuses
GET Retrieves all Portal User hydra:Collection 200 OK
POST Creates a new Portal User vocab:PortalUser vocab:PortalUser 201 Portal User created., 400 Bad Request

namedQueries (🔗)

Collection of all the Named Queries you have configured (plus those provided 'out of the box'). See the NamedQuery topic for further information

domain range readonly writeonly
vocab:Customer hydra:Collection True False
/customers/{0}/namedQueries
Method Label Expects Returns Statuses
GET Retrieves all Named Query hydra:Collection 200 OK
POST Creates a new Named Query vocab:NamedQuery vocab:NamedQuery 201 Named Query created., 400 Bad Request

originStrategies (🔗)

Collection of configuration settings for retrieving your registered images from their origin URLs. If your images come from multiple locations you will have multiple origin strategies. See the OriginStrategy topic.

domain range readonly writeonly
vocab:Customer hydra:Collection True False
/customers/{0}/originStrategies
Method Label Expects Returns Statuses
GET Retrieves all Origin Strategy hydra:Collection 200 OK
POST Creates a new Origin Strategy vocab:OriginStrategy vocab:OriginStrategy 201 Origin Strategy created., 400 Bad Request

authServices (🔗)

Collection of IIIF Authentication services available for use with your images. The images are associated with the auth services via Roles. An AuthService is a means of acquirung a role.

domain range readonly writeonly
vocab:Customer hydra:Collection True False
/customers/{0}/authServices
Method Label Expects Returns Statuses
GET Retrieves all Auth Service hydra:Collection 200 OK
POST Creates a new Auth Service vocab:AuthService vocab:AuthService 201 Auth Service created., 400 Bad Request

roles (🔗)

Collection of the available roles you can assign to your images. In order for a user to see an image, the user must have the role associated with the image, or one of them. Users interact with an AuthService to acquire a role or roles.

domain range readonly writeonly
vocab:Customer hydra:Collection True False
/customers/{0}/roles
Method Label Expects Returns Statuses
GET Retrieves all Space hydra:Collection 200 OK
POST Creates a new Space vocab:Space vocab:Space 201 Space created., 400 Bad Request

queue (🔗)

The Customer's view on the DLCS ingest queue. As well as allowing you to query the status of batches you have registered, you can POST new batches to the queue.

domain range readonly writeonly
vocab:Customer vocab:Queue True False
/customers/{0}/queue
Method Label Expects Returns Statuses
GET Returns the queue resource vocab:Queue
POST Submit an array of Image and get a batch back hydra:Collection vocab:Batch 201 Job has been accepted - Batch created and returned

spaces (🔗)

Collection of all the Space resources associated with your customer. A space allows you to partition images, have different default roles and tags, etc. See the Space topic.

domain range readonly writeonly
vocab:Customer hydra:Collection True False
/customers/{0}/spaces

keys (🔗)

Api keys allocated to this customer. The accompanying secret is only available at creation time. To obtain a key and a secret, make an empty POST to this collection with administrator privileges and the returned Key object will include the generates secret.

domain range readonly writeonly
vocab:Customer hydra:Collection True False
/customers/{0}/keys

storage (🔗)

Storage policy for the Customer

domain range readonly writeonly
vocab:Customer vocab:CustomerStorage True False
/customers/{0}/storage

acceptedAgreement

Has the customer accepted the EULA?

domain range readonly writeonly
vocab:Customer xsd:boolean True False