(GET) Belt Sections

Description

Supplies data relating to the belt sections registered in the system.  

 

URL

https://apiprod.pdsglobal.com/V2/api/equipment/beltsections/V3

Note: There are two non-production environments that can be used for testing.

 


Request

Type

GET

Headers

No header is required for this API Endpoint.

Parameters

Mandatory parameters are denoted by *

*

api_key: string(50) This is required for authentication. It is used to identify the user and determine access to the system. If you do not have your API key please contact PDS Support (support@pdsglobal.com).

businessName: string(50) The name of the business as recorded in the hierarchy. Can be obtained from the hierarchy or the Area Details API.

*

lastSynced: DateTime Used to retrieve only the records which have changed since the last call to the endpoint. On first call of the endpoint leave blank - this will return all records. Store the timestamp after every call and pass it in the lastSynced parameter to retrieve only records which have changed since that time.

The format is yyyy-MM-dd HH:mm:ss.sss (e.g. 2021-01-01 01:23:00.000).

Note that if both rowVersion and lastSynced are populated, rowVersion will take precedence. For some endpoints the lastSynced value is limited to 6 months.

page: integer Large datasets are broken down into pages with 2000 records per page. Use the page parameter to specify which page of the paged dataset to retrieve. Note that this number cannot be greater than the lastPage value returned by the first call to the endpoint.

lastPage: integer When a paged endpoint is called, it calculates the number of records it will return, then calculates the number of pages required.

This is an intensive operation which affects the performance of the endpoint. After calling the endpoint the first time the lastPage value is returned in the result. By passing that value in to the lastPage parameter on subsequent calls the service will know not to recalculate the number of pages.

Body

No body is required for this API Endpoint.


Response

Body

Object: ResponseEntity<string>

 

changedRecords[]

List of records returned by the call.

equipmentId: int
This is the unique identifier (primary key) for the equipment.

businessName: string(50)
The name of the business as recorded in the hierarchy.

groupName: string(50)
The name of the group as recorded in the hierarchy.

departmentName: string(50)
The name of the department as recorded in the hierarchy.

areaName: string(50)
The name of the area as recorded in the hierarchy.

areaType: string(50)
Defines the general equipment type for the area, such as Transfer Chute or Screens. This is configured in the Area Types dialog.

hash: integer

Sometimes referred to as SortOrder. All items of equipment have a sort order number assigned to them. It identifies them as an individual item within an area, and for some equipment it determines the sequence of the item.

equipmentType: string(50)
The type of equipment as specified in the Equipment Type dialog.

fullSpecification: string(350)

The specification recorded against the belt section, with additional size, cover, and grade information.

specification: string(255)

The specification recorded against the belt section. 

width: decimal(18,3)

The width of the belt section in the relevant Unit of Measurement.

skirtWidth: decimal(18,3)

The width of the skirt in the relevant Unit of Measurement.

topCover: decimal(18,3)

The size of the top cover in the relevant Unit of Measurement.

bottomCover: decimal(18,3)

The size of the bottom cover in the relevant Unit of Measurement.

grade: string(50)

The belt grade. Free text.

length: decimal(18,3)

The length of the belt section in the relevant Unit of Measurement.

breakerFabric: boolean

Used to indicate breaker fabric.

sealedEdge: boolean

Used to indicate a sealed edge.

rollNumber: string(50)

The roll number. Free text.

stationMarkers: string(50)

The station markers. Free text.

manufactureDate: DateTime

The date of manufacture for the equipment.

manufacturer: string(50)

The name of the manufacturer as configured in the Belt Manufacturer dialog

purchaseDate: DateTime

The date on which the belt was purchased.

purchaseWO: string(50)

The workorder reference/number for the purchase of the belt. Free text.

installed: boolean
Indicates whether the equipment is currently installed.

installDate: DateTime
The date the equipment was installed.

installWO: string(50)

The workorder reference/number for the install. Free text.

life: integer

Indicates the number of days the equipment has been installed for (or was installed for if no longer installed)

leadTime: integer

The number of days required to order the part.

replacementInterval: integer

The number of days the equipment is expected to last before replacement.

functionalLocation: string(50)

Unique code used to identify the equipment. Free text.

partNumber: string(50)

Unique code used for ordering the equipment. Free text.

documentLink: string(255)

Link or reference to documentation. Free text.

comments: string(255)

Comments entered against the equipment record. Free text.

cOutComments: string(255)

Comments entered by user at change out. Free text. 

reasonForReplacement: string(50)

The fault associated with the replacement as defined in the Reasons for Replacement dialog. 

reference

Not used 

lastSavedBy: string(50)
Identifies the user who last updated the record (email address).

lastSavedDateTime: DateTime
Indicates the last time the record was updated.

createdBy: string(50)

Identifies the user who created the record (email address). 

createdDate: DateTime

Indicates the date and time the record was created. 

attachedFiles: string(max)

Lists the names of all files attached to this equipment record. 

lastPage: integer

Indicates the page number of the last page when a paged endpoint is called. 

 

Response Status Code

See HTTP Response Codes and Errors

 


Examples

URL:
https://apiprod.pdsglobal.com/V2/api/equipment/beltsections/V3?api_key=ABC123

 

 

Response Body

{ 

  "changedRecords": [ 

        { 

            "equipmentId": 37274, 

            "businessName": "Mine Operations", 

            "groupName": "Raw Coal", 

            "departmentName": "Conveyors", 

            "areaName": "Automation Test", 

            "areaType": "Conveyors", 

            "hash": 1, 

            "equipmentType": "Belt Sections", 

            "fullSpecification": "100 100 100.0+100.0 ", 

            "specification": "100", 

            "width": 100, 

            "skirtWidth": 100, 

            "topCover": 100, 

            "bottomCover": 100, 

            "grade": null, 

            "length": null, 

            "breakerFabric": false, 

            "sealedEdge": false, 

            "rollNumber": null, 

            "stationMarkers": null, 

            "manufactureDate": null, 

            "manufacturer": null, 

            "purchaseDate": null, 

            "purchaseWO": null, 

            "installed": true, 

            "installDate": "2021-09-24T01:21:38.000Z", 

            "installWO": null, 

            "life": 24, 

            "leadTime": null, 

            "replacementInterval": null, 

            "functionalLocation": null, 

            "partNumber": null, 

            "documentLink": null, 

            "comments": null, 

            "cOutComments": null, 

            "reasonForReplacement": null, 

            "reference": null, 

            "lastSavedBy": "Test3@pdsglobal.com", 

            "lastSavedDate": "2021-09-24T01:21:51.790Z", 

            "createdBy": "Test3@pdsglobal.com", 

            "createdDate": "2021-09-24T01:21:51.787Z", 

            "attachedFiles": null 

        }], 

            "lastPage": 0 

}

prev next
Was this article helpful?
0 out of 0 found this helpful

Articles in this section

prev next

Related sections