Resource categories

Get all resource categories

Returns all categories of resources. This operation uses Pagination.

Request

[PlatformAddress]/api/connector/v1/resourceCategories/getAll

{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
    "Client": "Sample Client 1.0.0",
    "EnterpriseIds": 
    [
        "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "4d0201db-36f5-428b-8d11-4f0a65e960cc"
    ],
    "ResourceCategoryIds": [
        "5c0804f9-d03a-4b13-a57d-b00300781a41",
        "47d6b462-35ec-467e-a565-b00300781a41"
    ],
    "ServiceIds": [
        "9b3a6c54-63aa-4383-b50e-b0030078184b",
        "c0f71466-6c0b-4993-88ac-1794f6b7e958"
    ],
    "UpdatedUtc": {
        "StartUtc": "2023-05-05T00:00:00Z",
        "EndUtc": "2023-05-10T00:00:00Z"
    },
    "ActivityStates": [ "Active" ],
    "Limitation":{
        "Count": 10
    }
}

Property	Type	Contract	Description
ClientToken	string	required	Token identifying the client application.
AccessToken	string	required	Access token of the client application.
Client	string	required	Name and version of the client application.
EnterpriseIds	array of string	optional, max 1000 items	Unique identifiers of the Enterprises. If not specified, the operation returns the resource categories for all enterprises within scope of the Access Token.
ResourceCategoryIds	array of string	optional, max 1000 items	Unique identifiers of Resource categories.
ServiceIds	array of string	required, max 1000 items	Unique identifiers of Services to which the resource categories belong.
UpdatedUtc	Time interval	optional, max length 3 months	Interval in which the resource categories were updated.
ActivityStates	array of string Activity state	optional	Whether to return only active, only deleted or both records.
Limitation	Limitation	required	Limitation on the quantity of resource categories returned.

Response

{
    "ResourceCategories":[
        {
            "Id": "5c0804f9-d03a-4b13-a57d-b00300781a41",
            "EnterpriseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "ServiceId": "9b3a6c54-63aa-4383-b50e-b0030078184b",
            "IsActive": true,
            "Type": "Bed",
            "Names": {
                "en-US": "Bed 1"
            },
            "ShortNames": {
                "en-US": "Bed 1"
            },
            "Descriptions": {},
            "Ordering": 2,
            "Capacity": 1,
            "ExtraCapacity": 0,
            "ExternalIdentifier": null
        },
        {
            "Id": "47d6b462-35ec-467e-a565-b00300781a41",
            "EnterpriseId": "4d0201db-36f5-428b-8d11-4f0a65e960cc",
            "ServiceId": "c0f71466-6c0b-4993-88ac-1794f6b7e958",
            "IsActive": true,
            "Type": "Dorm",
            "Names": {
                "en-US": "Dorm 1"
            },
            "ShortNames": {
                "en-US": "Dorm 1"
            },
            "Descriptions": {},
            "Ordering": 1,
            "Capacity": 4,
            "ExtraCapacity": 0,
            "ExternalIdentifier": null
        }
    ],
    "Cursor": "47d6b462-35ec-467e-a565-b00300781a41"
}

Property	Type	Contract	Description
ResourceCategories	array of Resource category	optional	Resource categories of the resources.
Cursor	string	required	Unique identifier of the last and hence oldest resource category returned. This can be used in Limitation in a subsequent request to fetch the next batch of older resource categories.

Resource category

Property	Type	Contract	Description
Id	string	required	Unique identifier of the category.
EnterpriseId	string	required	Unique identifier of the Enterprise.
ServiceId	string	required	Unique identifier of the Service of the resource category.
IsActive	bool	required	Whether the resource category is still active.
Type	string	required	Resource category type.
Names	Localized text	required	All translations of the name.
ShortNames	Localized text	required	All translations of the short name.
Descriptions	Localized text	required	All translations of the description.
Ordering	number	required	Ordering of the category, lower number corresponds to lower category (note that neither uniqueness nor continuous sequence is guaranteed).
ExtraCapacity	number	required	Extra capacity that can be served (e.g. extra bed count).
ExternalIdentifier	string	optional, max 255 characters	Identifier of the resource category from external system.

Get all resource category assignments

Returns all resource category assignments. This operation uses Pagination.

Request

[PlatformAddress]/api/connector/v1/resourceCategoryAssignments/getAll

{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
    "Client": "Sample Client 1.0.0",
    "EnterpriseIds": 
    [
        "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "4d0201db-36f5-428b-8d11-4f0a65e960cc"
    ],
    "ResourceCategoryIds": [
        "5c0804f9-d03a-4b13-a57d-b00300781a41",
        "47d6b462-35ec-467e-a565-b00300781a41"
    ],
    "ResourceCategoryAssignmentIds": [
        "fb69fc51-c4e9-4ef6-874a-24bcfe74a894",
        "28704948-77df-4bb4-8f39-f8380dc8a914"
    ],
    "UpdatedUtc": {
        "StartUtc": "2023-11-01T00:00:00Z",
        "EndUtc": "2023-11-30T00:00:00Z"
    },
    "ActivityStates": [ "Active" ],
    "Limitation":{
        "Count": 10
    }
}

Property	Type	Contract	Description
ClientToken	string	required	Token identifying the client application.
AccessToken	string	required	Access token of the client application.
Client	string	required	Name and version of the client application.
EnterpriseIds	array of string	optional, max 1000 items	Unique identifiers of the Enterprises. If not specified, the operation returns the resource category assignments for all enterprises within scope of the Access Token.
ResourceCategoryIds	array of string	required, max 1000 items	Unique identifiers of Resource categories to which the resource category assignment belong.
ResourceCategoryAssignmentIds	array of string	optional, max 1000 items	Unique identifiers of Resource category assignment.
UpdatedUtc	Time interval	optional, max length 3 months	Interval in which the resource category assignments were updated.
ActivityStates	array of string Activity state	optional	Whether to return only active, only deleted or both records.
Limitation	Limitation	required	Limitation on the quantity of resource category assignments returned.

Response

{
    "ResourceCategoryAssignments":[
        {
            "Id": "fb69fc51-c4e9-4ef6-874a-24bcfe74a894",
            "ResourceId": "e5a34a69-d35e-4e85-a645-a9bc4ee3a80f",
            "CategoryId": "5c0804f9-d03a-4b13-a57d-b00300781a41",
            "IsActive": true,
            "CreatedUtc": "2023-10-01T11:48:57Z",
            "UpdatedUtc": "2023-10-28T11:48:57Z"
        },
        {
            "Id": "28704948-77df-4bb4-8f39-f8380dc8a914",
            "ResourceId": "90908a65-35fc-4856-b659-106f60b591e5",
            "CategoryId": "47d6b462-35ec-467e-a565-b00300781a41",
            "IsActive": true,
            "CreatedUtc": "2023-10-01T11:48:57Z",
            "UpdatedUtc": "2023-10-28T11:48:57Z"
        }
    ],
    "Cursor": "28704948-77df-4bb4-8f39-f8380dc8a914"
}

Property	Type	Contract	Description
ResourceCategoryAssignments	array of Resource category assignment	optional	Resource category assignments.
Cursor	string	required	Unique identifier of the last and hence oldest resource category assignment returned. This can be used in Limitation in a subsequent request to fetch the next batch of older resource category assignments.

Resource category assignment

Property	Type	Contract	Description
Id	string	required	Unique identifier of the assignment.
IsActive	bool	required	Whether the assignment is still active.
CategoryId	string	required	Unique identifier of the Resource category.
ResourceId	string	required	Unique identifier of the Resource assigned to the Resource category.
CreatedUtc	string	required	Creation date and time of the assignment in UTC timezone in ISO 8601 format.
UpdatedUtc	string	required	Last update date and time of the assignment in UTC timezone in ISO 8601 format.

Get all resource category image assignments

Returns all resource category image assignments. This operation uses Pagination.

Request

[PlatformAddress]/api/connector/v1/resourceCategoryImageAssignments/getAll

{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
    "Client": "Sample Client 1.0.0",
    "EnterpriseIds": 
    [
        "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "4d0201db-36f5-428b-8d11-4f0a65e960cc"
    ],
    "ResourceCategoryIds": [
        "5c0804f9-d03a-4b13-a57d-b00300781a41",
        "47d6b462-35ec-467e-a565-b00300781a41"
    ],
    "ResourceCategoryImageAssignmentIds": [
        "edb5f556-7afb-4650-8d4e-8c0a6fff784d",
        "9d18f5fb-cce5-4e70-9561-f7804262344b"
    ],
    "UpdatedUtc": {
        "StartUtc": "2023-11-01T00:00:00Z",
        "EndUtc": "2023-11-30T00:00:00Z"
    },
    "ActivityStates": [ "Active" ],
    "Limitation":{
        "Count": 10
    }
}

Property	Type	Contract	Description
ClientToken	string	required	Token identifying the client application.
AccessToken	string	required	Access token of the client application.
Client	string	required	Name and version of the client application.
EnterpriseIds	array of string	optional, max 1000 items	Unique identifiers of the Enterprises. If not specified, the operation returns the resource category image assignments for all enterprises within scope of the Access Token.
ResourceCategoryIds	array of string	required, max 1000 items	Unique identifiers of Resource categories to which the resource category image assignments belong.
ResourceCategoryImageAssignmentIds	array of string	optional, max 1000 items	Unique identifiers of Resource category image assignments.
UpdatedUtc	Time interval	optional, max length 3 months	Interval in which the resource category image assignments were updated.
ActivityStates	array of string Activity state	optional	Whether to return only active, only deleted or both records.
Limitation	Limitation	required	Limitation on the quantity of resource category image assignments returned.

Response

{
    "ResourceCategoryImageAssignments":[
        {
            "Id": "edb5f556-7afb-4650-8d4e-8c0a6fff784d",        
            "CategoryId": "5c0804f9-d03a-4b13-a57d-b00300781a41",
            "ImageId": "e910d008-fded-4af5-a84f-c00f92e3947d",
            "IsActive": true,
            "CreatedUtc": "2023-10-01T11:48:57Z",
            "UpdatedUtc": "2023-10-28T11:48:57Z"
        },
        {
            "Id": "9d18f5fb-cce5-4e70-9561-f7804262344b",            
            "CategoryId": "47d6b462-35ec-467e-a565-b00300781a41",
            "ImageId": "11056cdb-2045-49e0-821f-2b93905ff522",
            "IsActive": true,
            "CreatedUtc": "2023-10-01T11:48:57Z",
            "UpdatedUtc": "2023-10-28T11:48:57Z"
        }
    ],
    "Cursor": "28704948-77df-4bb4-8f39-f8380dc8a914"
}

Property	Type	Contract	Description
ResourceCategoryImageAssignments	array of Resource category image assignment	optional	Resource category image assignments.
Cursor	string	required	Unique identifier of the last and hence oldest resource category image assignment returned. This can be used in Limitation in a subsequent request to fetch the next batch of older resource category image assignments.

Resource category image assignment

Property	Type	Contract	Description
Id	string	required	Unique identifier of the assignment.
IsActive	bool	required	Whether the assignment is still active.
CategoryId	string	required	Unique identifier of the Resource category.
ImageId	string	required	Unique identifier of the image assigned to the Resource category.
CreatedUtc	string	required	Creation date and time of the assignment in UTC timezone in ISO 8601 format.
UpdatedUtc	string	required	Last update date and time of the assignment in UTC timezone in ISO 8601 format.

Resource category type

• Room

• Bed

• Dorm

• Apartment

• Suite

• Villa

• Site

• Office

• MeetingRoom

• ParkingSpot

• Desk

• TeamArea

• Membership

• Tent

• CaravanOrRV

• UnequippedCampsite

• ...