Поиск по сайту

API
Главная / API - Oversized cargo thresholds

Oversized cargo thresholds

Обновлено 30.10.2023
26 кб

General information

The service allows getting values of weight and dimensional characteristics, under which the cargo is considered oversized depending on the shipping type and on a certain date.

Oversized cargo thresholds

Method request

Request structure

Method address: https://api.dellin.ru/v1/oversized_cargo_thresholds.json

{
   "appkey":"00000000-0000-0000-0000-000000000000",
   "sessionID":"00000000-0000-0000-0000-000000000000",
   "serviceKind":"auto",
   "periodFrom":"2023-09-18T22:11:21"
}

Method address: https://api.dellin.ru/v1/oversized_cargo_thresholds.xml

<request>
   <appkey>00000000-0000-0000-0000-000000000000</appkey>
   <sessionID>00000000-0000-0000-0000-000000000000</sessionID>
   <serviceKind>auto</serviceKind>
   <periodFrom>2023-09-18T22:11:21</periodFrom>
</request>

Description of parameters

Request
Request
ParameterRequiredTypeDescription
appkeyYesstringApplication key. To get the key, register
sessionIDNostringTo get the session ID, use the "User Authorization" method
serviceKindNostring

Shipping type.

Available values:

  • auto- by truck;
  • express;
  • avia.

If the parameter is not passed, then the response contains values ​​for all shipping types

periodFromNostring

The date on which you need to receive the parameters of the oversized cargo.

Format: "YYYY-MM-DDTHH:MM:SS".

Default value: current date

Method response

Response structure

{
   "metadata":{
      "status":200,
      "generated_at":"2023-09-18 22:11:21"
   },
   "data":[
      {
         "oversizedHeight":2.34,
         "oversizedLength":5.11,
         "serviceKind":"auto",
         "oversizedVolume":2.01,
         "oversizedWeight":100,
         "oversizedWidth":2.34
      }
   ]
}
<response>
   <metadata>
      <status>200</status>
      <generated_at>2023-09-18 22:11:21</generated_at>
   </metadata>
   <data>
      <oversizedHeight>2.34</oversizedHeight>
      <oversizedLength>5.11</oversizedLength>
      <serviceKind>auto</serviceKind>
      <oversizedVolume>2.01</oversizedVolume>
      <oversizedWeight>100</oversizedWeight>
      <oversizedWidth>2.34</oversizedWidth>
   </data>
</response>

Description of parameters

Response
Response
ParameterTypeDescription
metadataobjectSystem information
metadata.statusintegerEmulated status http-code. If successful, code 200 is returned
metadata.generated_atstring

Server response date and time.

Format: YYYY-MM-DD HH:MM:SS

dataobjectOversized cargo thresholds

Data
Data
ParameterTypeDescription
oversizedHeightdecimalOversized height
oversizedLengthdecimalOversized length
serviceKindstring

Shipping type.

Possible values:

  • auto- by truck;
  • express;
  • avia.
oversizedVolumedecimalOversized volume
oversizedWeightdecimalOversized weight
oversizedWidthdecimalOversized width

Error handling

The common API errors are used with the method, for errors format description and errors list see Errors of API methods.