API сервиса «Груз на СВХ» - История изменений

Belousov: /* API */

2024-05-16T10:04:01Z

‎API

Krashennikova в 07:42, 5 октября 2022

2022-10-05T07:42:30Z

Krashennikova в 07:40, 5 октября 2022

2022-10-05T07:40:33Z

Krashennikova в 07:40, 5 октября 2022

2022-10-05T07:40:15Z

Krashennikova в 07:39, 5 октября 2022

2022-10-05T07:39:56Z

Krashennikova в 07:37, 5 октября 2022

2022-10-05T07:37:58Z

Kisina в 09:31, 27 июня 2022

2022-06-27T09:31:59Z

Krashennikova в 09:07, 8 сентября 2021

2021-09-08T09:07:16Z

Belousov в 11:27, 10 августа 2020

2020-08-10T11:27:02Z

Belousov: Новая страница: «== О сервисе == Сервис "Груз на СВХ" https://www.alta.ru/svh-gruz/ позволяет отслеживать прибытие груза…»

2020-08-03T11:49:41Z

Новая страница: «== О сервисе == Сервис "Груз на СВХ" https://www.alta.ru/svh-gruz/ позволяет отслеживать прибытие груза…»

Новая страница

== О сервисе ==

Сервис "Груз на СВХ" https://www.alta.ru/svh-gruz/ позволяет отслеживать прибытие груза на склад по номеру контейнера, документа или транспортного средства. Поиск осуществляется по складам, предоставившим свои данные для сервиса.

== API ==

=== Поиск ===

С помощью '''GET'''-запроса на URL https://www.alta.ru/svh-gruz/search/ передаются параметры

'''Параметры:'''
#containerNumber - номер контейнера
#transportId - транспортное средство
#transportNumber - транспортный документ
#declNumber - номер декларации
#hashKey - ключ для поиска по определенному participantId

'''Ответ:'''
Пример ответа:

<syntaxhighlight lang=json>
{
"content": [
{
"storeName": "ПЗТК ООО \"Пасифик Лоджистик\"",
"certificate": "№10702/231216/00033/6 от 18.04.2017",
"internalNumber": "№0002474 от 18.04.2017",
"acceptDate": 1492446600000,
"deadLineDate": 1497733200000,
"regNumber": "10702030/180417/0046239",
"documentId": "03D4A9F1-1212-49BF-8C26-518D62776676",
"containerNumbers": [
"SKLU3518823",
"SKLU3518823"
],
"transportNumbers": [
"02011 Коносамент №SNKO02A170300708 от 07.04.2017",
"02011 Коносамент №SNKO02A170300708 от 07.04.2017",
"02011 Коносамент №SNKO02A170300708 от 07.04.2017"
],
"totalPackageNumber": 296,
"transportIdentifiers": [
"VOSTOCHNY VOYAGER 0101W",
"VOSTOCHNY VOYAGER 0101W",
"VOSTOCHNY VOYAGER 0101W"
],
"certificateLic": "LIC_PERMITION",
"weight": null,
"dtDataList": [
{
"number": "10702030/200417/0030708",
"totalPackageNumber": 296,
"weight": [
"3915,54 КГ",
"3915,54 КГ",
"3915,54 КГ"
],
"documentName": null,
"documentKind": null,
"dtRegNumber": null,
"messageType": null
}
],
"warehouseOwner": {
"organizationName": "ПЗТК ООО \"Пасифик Лоджистик\"",
"ogrn": "1122536008572",
"inn": "2536255389",
"kpp": "253601001",
"addressLine": "690001, г. Владивосток, ул. Дальзаводская, д. 2",
"certificateKind": "lic_Permition",
"certificateNumber": "10702/231216/00033/6",
"certificateDate": 1482440400000
},
"status": "REGISTERED",
"changeStatusDate": null,
"participantId": null
}
],
"totalSize": 204587,
"pageSize": 20,
"pageElements": 20,
"responseMessage": "Найдено слишком много совпадений, для получения более точной информации уточните критерии поиска."
}
</syntaxhighlight>

@@ Строка 9: / Строка 9: @@
 <br>
 Логин и пароль для обращения по API необходимо получить в личном кабинете https://www.alta.ru/user/, заключив договор на использование онлайн-сервисов. В настройках договора будут указаны технический логин и пароль.
-Данный сервис работает без тарификации.
 === Запрос на поиск ===

@@ Строка 110: / Строка 110: @@
 </pre>
-'''Пример ошибок:'''
+=== Возможные ошибки ===
 Код ответа 404:

@@ Строка 7: / Строка 7: @@
 Доступ к API предоставляется по URL https://www.alta.ru/svh-gruz/search/api/v1/.
 Для использования сервиса необходима авторизация с помощью логина и пароля.
+<br>
 Логин и пароль для обращения по API необходимо получить в личном кабинете https://www.alta.ru/user/, заключив договор на использование онлайн-сервисов. В настройках договора будут указаны технический логин и пароль.
 Данный сервис работает без тарификации.

@@ Строка 7: / Строка 7: @@
 Доступ к API предоставляется по URL https://www.alta.ru/svh-gruz/search/api/v1/.
 Для использования сервиса необходима авторизация с помощью логина и пароля.
 Логин и пароль для обращения по API необходимо получить в личном кабинете https://www.alta.ru/user/, заключив договор на использование онлайн-сервисов. В настройках договора будут указаны технический логин и пароль.
 Данный сервис работает без тарификации.

@@ Строка 7: / Строка 7: @@
 Доступ к API предоставляется по URL https://www.alta.ru/svh-gruz/search/api/v1/.
 Для использования сервиса необходима авторизация с помощью логина и пароля.
-Логин и пароль для обращения по API необходимо получить в личном кабинете www.alta.ru/user/, заключив договор на использование онлайн-сервисов. В настройках договора будут указаны технический логин и пароль.
+Логин и пароль для обращения по API необходимо получить в личном кабинете https://www.alta.ru/user/, заключив договор на использование онлайн-сервисов. В настройках договора будут указаны технический логин и пароль.
 Данный сервис работает без тарификации.

@@ Строка 7: / Строка 7: @@
 Доступ к API предоставляется по URL https://www.alta.ru/svh-gruz/search/api/v1/.
 Для использования сервиса необходима авторизация с помощью логина и пароля.
 === Запрос на поиск ===
@@ Строка 16: / Строка 18: @@
 #n_trans_doc - транспортный документ
 #n_dt - номер декларации
-#login - логин в открытом виде
+#логин в открытом виде
-#secret - MD5-хеш от сгенерированной строки '''параметры запроса + логин + md5-хэш от пароля''', все параметры разделены знаком двоеточия «:»
+#секрет - MD5-хеш от сгенерированной строки параметры запроса +  логин + md5-хэш от пароля, все параметры разделены знаком “:” (двоеточие)
 ----
 <code>
@@ Строка 33: / Строка 35: @@
 Обратите внимание, даже если параметр пустой, его все равно необходимо добавить в порядке следования, для данного примера формула вычисления secret такова:
 : пусто : 555 : пусто : testlogin : e16b2ab8d12314bf4efbd6203906ea6c = 7fcb20d2c25956e38dbd2c9a6c3f9720<br>
-итоговый URL: https://www.alta.ru/svh-gruz/search/api/v1/?n_k=123&n_trans=&n_trans_doc=555&n_dt=&login=testlogin&secret=7fcb20d2c25956e38dbd2c9a6c3f9720 <br>
+Таким образом итоговый URL, на который совершается GET-запрос: https://www.alta.ru/svh-gruz/search/api/v1/?n_k=123&n_trans=&n_trans_doc=555&n_dt=&login=testlogin&secret=7fcb20d2c25956e38dbd2c9a6c3f9720 <br>
 === Ответ ===
@@ Строка 43: / Строка 45: @@
 Код ответа 200:
 <pre>
-−
+{
-"content": [
+  "content": [
+     {
-       "storeName": "ПЗТК ООО \"Пасифик Лоджистик\"",
+       "storeName": "ООО \"Лоджистик\"",
-       "certificate": "№10702/231216/00033/6 от 18.04.2017",
+       "certificate": "№10000/231000/00000/1 от 01.01.2011",
-       "internalNumber": "№0002474 от 18.04.2017",
+       "internalNumber": "№0000001 от 11.11.2011",
-       "acceptDate": 1492446600000,
+       "acceptDate": "2011-01-11 00:00:00",
-       "deadLineDate": 1497733200000,
+       "deadLineDate": "2011-04-12 00:00:00",
-       "regNumber": "10702030/180417/0046239",
+       "regNumber": "10000011/110411/0010001",
-       "documentId": "03D4A9F1-1212-49BF-8C26-518D62776676",
+       "documentId": "03333111-1212-4949-8826-225566776677",
        "containerNumbers": [
-         "SKLU3518823",
+         "SKLU0000003",
-         "SKLU3518823"
+         "SKLU0000002"
        ],
        "transportNumbers": [
-         "02011 Коносамент №SNKO02A170300708 от 07.04.2017",
+         "02011 Коносамент №253-900800200400 от 01.01.2011",
-         "02011 Коносамент №SNKO02A170300708 от 07.04.2017",
+         "02011 Коносамент №200-900800200400 от 01.01.2011",
-         "02011 Коносамент №SNKO02A170300708 от 07.04.2017"
+         "02011 Коносамент №250-900800200400 от 01.01.2011"
        ],
-       "totalPackageNumber": 296,
+       "totalPackageNumber": 100,
        "transportIdentifiers": [
-         "VOSTOCHNY VOYAGER 0101W",
+         "VOSTOCHNY VOYAGER 100X",
-         "VOSTOCHNY VOYAGER 0101W",
+         "VOSTOCHNY VOYAGER 100X",
-         "VOSTOCHNY VOYAGER 0101W"
+         "VOSTOCHNY VOYAGER 100X"
        ],
        "certificateLic": "LIC_PERMITION",
@@ Строка 72: / Строка 74: @@
        "dtDataList": [
+         {
-           "number": "10702030/200417/0030708",
+           "number": "10002000/110311/0030777",
-           "totalPackageNumber": 296,
+           "totalPackageNumber": 100,
            "weight": [
-             "3915,54 КГ",
+             "1000,00 КГ",
-             "3915,54 КГ",
+             "1000,00 КГ",
-             "3915,54 КГ"
+             "1000,00 КГ"
            ],
            "documentName": null,
@@ Строка 86: / Строка 88: @@
        ],
        "warehouseOwner": {
-         "organizationName": "ПЗТК ООО \"Пасифик Лоджистик\"",
+         "organizationName": "ООО \"Лоджистик\"",
-         "ogrn": "1122536008572",
+         "ogrn": "1133536007552",
-         "inn": "2536255389",
+         "inn": "2226255577",
-         "kpp": "253601001",
+         "kpp": "225501001",
-         "addressLine": "690001, г. Владивосток, ул. Дальзаводская, д. 2",
+         "addressLine": "290900, г. Москва, ул. Гагарина, д. 1",
          "certificateKind": "lic_Permition",
-         "certificateNumber": "10702/231216/00033/6",
+         "certificateNumber": "10000/231000/00000/1",
-         "certificateDate": 1482440400000
+         "certificateDate": "2011-01-01 00:00:00"
        },
        "status": "REGISTERED",
@@ Строка 100: / Строка 102: @@
+     }
    ],
-   "totalSize": 204587,
+   "totalSize": 1,
-   "pageSize": 20,
+   "pageSize": 1,
-   "pageElements": 20,
+   "pageElements": 1,
-   "responseMessage": "Найдено слишком много совпадений, для получения более точной информации уточните критерии поиска."
+   "responseMessage": ""
+}
 </pre>
@@ Строка 116: / Строка 118: @@
 <pre>
 {"error":"Ошибка запроса, обратитесь к администратору сайта"}
 </pre>
 [[Категория:Автоматизация]]
 [[Категория:Web-Сервисы]]

@@ Строка 1: / Строка 1: @@
 == О сервисе ==
-Сервис "Груз на СВХ" https://www.alta.ru/svh-gruz/ позволяет отслеживать прибытие груза на склад по номеру контейнера, документа или транспортного средства. Поиск осуществляется по складам,  предоставившим свои данные для сервиса.
+Сервис "Груз на СВХ" https://www.alta.ru/svh-gruz/ позволяет получить информацию о грузе в json формате, поступившем на склады временного хранения. По номеру транспортного документа, контейнера, транспортного средства или номера декларации предоставляется информация о размещении груза на СВХ.
 == API ==
-=== Поиск ===
+Доступ к API предоставляется по URL https://www.alta.ru/svh-gruz/search/api/v1/.
-С помощью '''GET'''-запроса на URL https://www.alta.ru/svh-gruz/search/ передаются параметры
+=== Запрос на поиск ===
-'''Параметры:'''
+Для поиска необходимо отправлять GET-запрос по URL https://www.alta.ru/svh-gruz/search/api/v1/, содержащий следующие GET-параметры:
 #n_k - номер контейнера
 #n_trans - транспортное средство
 #n_trans_doc - транспортный документ
 #n_dt - номер декларации
-#json=2 - для получения ответа в json формате
+#login - логин в открытом виде
-'''Ответ:'''
+Запрос с параметрами:
-Пример ответа:
+n_k = 123, n_trans = пусто, n_trans_doc = 555, n_dt = пусто. <br>
-<syntaxhighlight lang=json>
+=== Ответ ===
-−
-  "content": [
+При возникновении ошибок возвращается код ответа сервера отличный от 200, а также описание ошибки в JSON-массиве.
+     {
        "storeName": "ПЗТК ООО \"Пасифик Лоджистик\"",
@@ Строка 81: / Строка 103: @@
    "pageSize": 20,
    "pageElements": 20,
    "responseMessage": "Найдено слишком много совпадений, для получения более точной информации уточните критерии поиска."
+}
-</syntaxhighlight>
+</pre>
 [[Категория:Автоматизация]]
 [[Категория:Web-Сервисы]]

← Предыдущая		Версия 11:27, 10 августа 2020
Строка 83:		Строка 83:
	}		}
	</syntaxhighlight>		</syntaxhighlight>
		+
		+
		+
		+	[[Категория:Автоматизация]]
		+	[[Категория:Web-Сервисы]]