Products

API Description

This API allows the client to request the Products that are contained in the customer's Commercial Agreement with Tenaris.

| Operation | Description | Specification |

| GET /products | Retrieve all the products. | GET |

Environments

Static mock: Tenaris provides static mocks as a first approach, in order to allow developers to start exploring our API suite fast and easily. You do not need to use a token in order to try out a static mock.

URL https://customerapi-dev.azure-api.net/public/products

Sandbox: To test in the "Sandbox" environment you need to use an access token. In order to get it, you have to complete the "First steps" guide on the "Tenaris Developers" site. If you have questions regarding how to get your access token, please go to Authentication and Authorization

URL https://customerapi-dev.azure-api.net/sb/products

Production: To test in the "Production" environment you need to use an access token.

URL https://customerapi-dev.azure-api.net/products

Get Products

The Tenaris API requires authentication - specifically requests made on behalf of a user. Authenticated requests require an access_token. These tokens are unique to a user and should be stored securely. Access tokens may expire at any time in the future. In order to know more about this, please make sure you have already completed the First Steps guide.

Test your API

Here are the example request and response for your test.

curl -X GET https://customerapi-dev.azure-api.net/sb/products?pageSize=10&pageNumber=1&sortField=description&sortMode=asc

Response:

{

"page": {

"pageSize": 10,

"pageNumber": 1,

"pageLimit": 1,

"code": 200

},

"results": [

{

"id": "21336",

"description": "5 1/2\" 20.00# 2.00FT.-DONASID--TXP BTC",

"uoms": [{"code": "ST", "description": "Pieces"}],

"category": {"id": "42", "description": "Test_agreement"},

"enableThreads": false,

"material": "PJTXP00000000C0003"

}

]

}

Errors

The General Errors table can be found on the Support section.

| ERROR | DESCRIPTION |

| 401 | ERROR IN TOKEN VALIDATION. There is an issue with the token used in the request. |

| 403 | USER NOT AUTHORIZED. There is an error in the credentials. |

| 404 | PAGING PARAMETERS ERROR. Bad request. |

| 500 | GENERAL ERROR. Server side error. |