Get inventory types

get

/rest/ofscMetadata/v1/inventoryTypes

The operation retrieves a collection of inventory types.

Configuration: You must grant permissions to the Core API and must at least set Read-Only access to the Inventory type entity in the Configuration, Applications (API permissions) screen.

Request

Query Parameters
  • The translation language code.

    Based on the value of this parameter, the translations for the name and unit of measurement of the inventory type is returned in the 'name' and 'unitOfMeasurement' fields.

    • If the value is specified, then the translated value is returned in the 'name' and 'unitOfMeasurement' fields, and the 'translations' field is not returned in the response.
    • If translation for the specified language does not exist, then the value in the 'name' and 'unitOfMeasurement' fields is returned in English.
    • If the value is not specified, then the 'translations' field is returned in the response and contains the translations to every language in the system.

    For the list of supported language codes, see Supported Language Codes.

  • The number of inventory type records to be returned in the response. The minimum value that can be specified is 1 and the maximum value that can be specified is 100. If the specified value is greater than 100, zero, or if no value is specified, then it defaults to 100.
  • The record number from which the retrieval starts. The default value is zero. If no value is specified, then it defaults to zero. The value zero indicates that the retrieval will start from the beginning of the collection.
Back to Top

Response

Supported Media Types

200 Response

This section describes the 200 status response for this operation.
Body ()
Root Schema : InventoryTypes
Type: object
An array of the inventory type records in the collection.
Show Source
Nested Schema : items
Type: array
Show Source
Nested Schema : Inventory Type
Type: object
Title: Inventory Type
Show Source
  • Title: Active
    Contains one of the following values: true or false.

    If true, then the inventory type is listed as a possible value in the 'Inventory Type' drop-down list in Manage or Mobility apps while creating an inventory. If false, then the inventory type is not listed as a value in the drop-down list. The default value is true.

  • Title: Label
    The label of the inventory property used to identify the model of the inventory.
  • Title: Model Property
    Label of an inventory property which is used to identify model of this inventory
  • Title: Name
    Minimum Length: 1
    Maximum Length: 40
    The translation for the name of the inventory type.

    If the value of the language parameter is specified, then the name is provided in the specified language. If the value is not specified, then the name is provided in English, unless the request is performed using an OFSC user account which is linked to an API application (in this case the name is provided in the language of the user making the request).

  • Title: Non Serialized
    Contains one of the following values: true or false. If true, then the inventory is serialized, that is, it has a serial number. If false, then the inventory is non-serialized, that is, it does not have a serial number.
  • Translations
    Title: Translations
    The list of translations associated with the name and unit of measurement of the inventory type. The list is only returned if the language parameter is not specified in request.
  • Title: Unit Of Measurement

    The translation for the unit of measurement of the inventory type.

    If the value of the language parameter is specified, then the unit of measurement is provided the specified language. If the value is not specified, then the unit of measurement is provided in English, unless the request is performed using an OFSC user account which is linked to an API application (in this case the unit of measurement is provided in the language of the user making the request).

    This field is present for non-serialized inventory types only.

Nested Schema : Translations
Type: array
Title: Translations
The list of translations associated with the name and unit of measurement of the inventory type. The list is only returned if the language parameter is not specified in request.
Show Source
Nested Schema : Translation
Type: object
Show Source
  • This field contains language code of a text translation, it conatains two characters length code in responses (e.g. 'en', 'es') but can be used in requests as extended ISO code (e.g. 'en-US') as well as old two character format.
  • This field is used only in responses and returns ISO language code (e.g. 'en-US'). This field is ignored in the requests (use 'language' instead)

Default Response

This section describes the default error response for this operation.
Body ()
Root Schema : Error
Type: object
Error response
Show Source
Back to Top

Examples

Example 1

The following example shows how to obtain a collection of inventory types by submitting a GET request on the REST resource using cURL.

Use the cURL command with the following syntax:

curl -u '<CLIENT-ID>@<INSTANCE-NAME>:<CLIENT-SECRET>' \
     -H 'Accept: application/json' \
     'https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/inventoryTypes/?limit=2&offset=2'

Response Header Example

The following shows an example of the response header:

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 24 Jan 2018 12:28:18 GMT
Content-Type: application/json; charset=utf-8
Connection: close

Response Body Example

The following shows an example of the response body in JSON format:

{
    "hasMore": true,
    "totalResults": 10,
    "limit": 2,
    "offset": 2,
    "items": [
        {
            "label": "DT",
            "name": "Digital Telephony",
            "active": true,
            "nonSerialized": false,
            "modelProperty": "inventory_model",
            "translations": [
                {
                    "language":"en",
                    "name": "Digital Telephony",
                    "languageISO": "en-US"
                },
                {
                    "language":"es",
                    "name": "Telefon??a digital",
                    "languageISO": "es-ES"
                }
            ],
            "links": [
                {
                    "rel": "describedby",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/inventoryTypes"
                }
            ]
        },
        {
            "label": "EC",
            "name": "Ethernet Cable",
            "unitOfMeasurement": "ft",
            "active": true,
            "nonSerialized": true,
            "modelProperty": "inventory_model",
            "translations": [
                {
                    "language":"en",
                    "name": "Ethernet Cable",
                    "unitOfMeasurement": "ft",
                    "languageISO": "en-US"
                },
                {
                    "language":"es",
                    "name": "Cable Ethernet",
                    "unitOfMeasurement": "m",
                    "languageISO": "es-ES"
                }
            ],
            "links": [
                {
                    "rel": "describedby",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/inventoryTypes"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "canonical",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/inventoryTypes/?limit=2&offset=2"
        },
        {
            "rel": "prev",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/inventoryTypes/?limit=2&offset=0"
        },
        {
            "rel": "next",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/inventoryTypes/?limit=2&offset=4"
        },
        {
            "rel": "describedby",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/inventoryTypes"
        }
    ]
}

Example 2

The following example shows how to obtain a collection of inventory types by using the language parameter with the GET request on the REST resource.

Use the cURL command with the following syntax:

curl -u '<CLIENT-ID>@<INSTANCE-NAME>:<CLIENT-SECRET>' \
     -H 'Accept: application/json' \
     'https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/inventoryTypes/?language=en-US&limit=2&offset=2'

Response Header Example

The following shows an example of the response header.

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 24 Jan 2018 12:28:18 GMT
Content-Type: application/json; charset=utf-8
Connection: close

Response Body Example

The following shows an example of the response body in JSON format:

{
    "hasMore": true,
    "totalResults": 10,
    "limit": 2,
    "offset": 2,
    "items": [
        {
            "label": "DT",
            "name": "Digital Telephony",
            "active": true,
            "nonSerialized": false,
            "modelProperty": "inventory_model",
            "links": [
                {
                    "rel": "describedby",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/inventoryTypes"
                }
            ]
        },
        {
            "label": "EC",
            "name": "Ethernet Cable",
            "unitOfMeasurement": "ft",
            "active": true,
            "nonSerialized": true,
            "modelProperty": "inventory_model",
            "links": [
                {
                    "rel": "describedby",
                    "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/inventoryTypes"
                }
            ]
        }
    ],
    "links": [
        {
            "rel": "canonical",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/inventoryTypes/?limit=2&offset=2"
        },
        {
            "rel": "prev",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/inventoryTypes/?limit=2&offset=0"
        },
        {
            "rel": "next",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/inventoryTypes/?limit=2&offset=4"
        },
        {
            "rel": "describedby",
            "href": "https://<instance_name>.etadirect.com/rest/ofscMetadata/v1/metadata-catalog/inventoryTypes"
        }
    ]
}
Back to Top