CountPartNumbers
Number of part numbers
Introduction
Find the number of unique part numbers for one catalog, one category or one product.
API Key
This web service requires an API Key. Please use the form to request your API Key.
Description
This API returns the number of unique part numbers depending on the level of data. The number of part numbers is only for the ones which can be predefined. If a part number depends on a manual input, it can not be counted. The number includes the sum of all the sub products under the selected level (catalog or category).
Building a URL
The CountPartNumbers API request takes the following form:
https://ws.tracepartsonline.net/tpowebservices/CountPartNumbers?parameters
Parameters
Certain parameters are required while others are optional. As it is standard in URLs, all parameters are separated using the ampersand (&) character. The list of parameters and their possible values are enumerated below.
Required parameters
| Parameter Name | Data type | Default value | Description |
|---|---|---|---|
| ApiKey | string | none | Code calling an API to track and control how the API is used |
| Format | string | none | Answer file type (xml, json) |
| ClassificationID | string | none | ClassificationId given by the CatalogsList API |
Optional parameters
| Parameter Name | Data type | Default value | Description |
|---|---|---|---|
| UserEmail | string | none | User email / User ID |
| ActiveJsonLight | boolean | 0 | Enables the light version when json is the answer file type |
| Path | string | root of the catalog | Category path which contents a list of product(s) given by the CategoriesList API |
| PartID | string | none | Product ID given by the ProductsList |
Example of CountPartNumbers API
The request below returns the number of part numbers for the ASCO Numatics catalog, for the “Pneumatics” category, as an xml file.
https://ws.tracepartsonline.net/tpowebservices/CountPartNumbers?ClassificationId=ASCO_JOUCOMATIC&Path=/F_ASJC/F_ASJC.ASJC1/&Format=xml&ApiKey={ApiKey}
By changing the Format and adding the ActiveJsonLight, CountPartNumbers returns the number, as a light Json file.
https://ws.tracepartsonline.net/tpowebservices/CountPartNumbers?ClassificationId=ASCO_JOUCOMATIC&Path=/F_ASJC/F_ASJC.ASJC1/&Format=json&ActiveJsonLight=1&ApiKey={ApiKey}
CountPartNumbers responses
CountPartNumbers responses are returned in the format indicated by the Format parameter within the URL request’s path.
JSON Output
A sample HTTP request is shown below, displaying the number of part numbers.
{
"count":"140584",
}
XML Output
Same example as above.
<WsCountPartNumbers>
<Count>140584</Count>
</WsCountPartNumbers>
CountPartNumbers response elements
CountPartNumbers responses contain one element:
- “count”: it is the number of unique part numbers in all products of the current catalog/category and the sub categories
Developer support
Please contact us for any problem, question or comment related to this content integration.
Last updated September 26, 2017
Updated 9 months ago