Skip to main content

Resources

TypeBase PathTrigger Name
REST resource~{realm}/resources/resources

This resource holds all bookable resources, like dinner tables, hairdressing chairs, rooms etc. Resources may be from other resources, such as orders and Resource Maps, which is used to group resources into rooms or sections, and to define a visual layout of where the resources are located within that section.

A resource is always bound to a specific location.

Endpoints

NameMethodRelative PathPayloadResponseDescription
addResourcePOST~{realm}/resources/ResourceStored_ResourceAdds a new location to the list.
listResourcesGET~{realm}/resources/N/AStored_Resource[]Retrieves a list of resources.
getResourceGET~{realm}/resources/{id}N/AStored_ResourceRetrieves a location.
putResourcePUT~{realm}/resources/{id}ResourceStored_ResourceReplaces a location.
updateResourcePATCH~{realm}/resources/{id}Partial_ResourceStored_ResourceUpdates specified location fields.
removeResourceDELETE~{realm}/resources/{id}N/AN/ADeletes a location.

Permissions

PermissionDescription
edit-resourcesClient is allowed to add new resources and to modify or delete existing resources.
show-resourcesClient is allowed to query the location list and to fetch individual resources.

Entities

Interface Resource

interface Resource {
'location': number;
'name': string;
'id'?: number;
'created'?: DateTime;
'updated'?: DateTime;
'deleted'?: DateTime;
'updated-by'?: number;
'updated-from'?: number;
'tags'?: string[];
'labels'?: number[];
}
PropertyData TypeDescription
nameStringName of the resource.
locationInt64At what location the resource is located.
idInt64?The resource ID of this entity.
createdDateTime?Date and time when this entity was first created.
updatedDateTime?Date and time when this entity was last modified.
deletedDateTime?Date and time when this entity was deleted.
updated-byInt64?ID of User who last modified this entity.
updated-fromInt64?ID of Till (trusted device) which last modified this entity.
labelsInt64[]?A list of Label IDs associated with this entity.