Руководство разработчика по подключению и использованию API для сервисов сайта AZM24.RU
Для использования API необходимо предварительно зарегистрироваться на сайте azm24.ru в качестве покупателя.
По индивидуальному запросу к менеджерам компании вам предоставляется api_id – идентификатор, который следует передавать при каждом обращении к сервисам.
Обращение к API осуществляется посредством отправки GET запросов по адресу https://azm24.ru/api.php
Поиск предложений
Поиск предложений в системе осуществляется линейно, то есть по запросу номера детали возвращаются все предложения всех производителей.
Параметры запроса:
|
api_id |
Идентификатор пользователя |
|
q |
Номер искомой детали |
|
isBot |
1 – если запрос инициирован поисковыми роботами; |
Пример:
GET
https://azm24.ru/api.php?api_id=5ae77410-462a-4103-837b-1eabd9192ede&q=1234&isBot=0
Ответ приходит в формате JSON:
[
{ "guid":"532d6d4b-d91e-ac4c-7b16-db85515deb7a",
"maker":"A-TECH",
"detail":"БОЛТ M8X1,5 L=75",
"detail_num":"123456",
"is_cross":"0",
"quantity":"10",
"lot_quantity":"1",
"days_from":"13",
"days_to":"13",
"stat":"100.00",
"price":"23.75",
"oguid":"66c9287c-bbd5-11e8-abea-06159600010c"
},
…
]
|
guid |
Уникальный идентификатор строки (зарезервирован на будущее) |
|
maker |
Производитель |
|
detail |
Наименование детали |
|
detail_num |
Номер детали |
|
is_cross |
1 – замена/аналог 0 – оригинал |
|
quantity |
Количество на складе |
|
lot_quantity |
Минимальная партия |
|
days_from |
Минимальное время поставки до склада в Новосибирске |
|
days_to |
Максимальное время поставки до склада в Новосибирске |
|
stat |
Вероятность поставки |
|
price |
Цена |
|
oguid |
Идентификатор предложения (требуется для оформления заказа) |
Создание заказа
Для создания заказа не требуется предварительного размещения товара в корзине и дополнительной переоценки и проверки. Заказ формируется в системе сразу после поступления запроса и в дальнейшем его состояние отслеживается через статусы.
|
api_id |
Идентификатор пользователя |
|
page |
order (статический параметр) |
|
task |
create (статический параметр) |
|
sid |
Идентификатор предложения (oguid) из результатов поиска предложений |
|
quantity |
Требуемое количество |
Возвращаемое значение
|
result |
ok – в случае удачного размещения outdated – если предложение устарело, и заказ не может быть создан error – прочая ошибка |
|
order_id |
Идентификатор созданного заказа |
Проверка состояния заказа
|
api_id |
Идентификатор пользователя |
|
page |
order (статический параметр) |
|
task |
state (статический параметр) |
|
order_id |
Идентификатор заказа полученный при создании |
Ответ:
{
"order_id":"70a6d24a-bbd5-11e8-82cc-06159600010c",
"result":"ok",
"states":
[
{
"state":3,
"quantity":1
},
…
]
}
В ответе может содержаться информация о нескольких статусах одновременно и количество единиц товара, соответствующее этому количеству. Например, из заказанных 5 позиций 3 может быть в пути, а 2 доставлены на склад.
Значения статусов:
0: c_error => "AZM24: Ошибка при обработке заказа"
1: c_created => "AZM24: Создан заказ"
2: c_waiting_payment => "AZM24: Ожидание оплаты"
3: c_in_work => "AZM24: В работе"
4: c_bought => "AZM24: Выкуплен у поставщика"
5: c_transit => "AZM24: В пути"
6: c_in_office => "AZM24: Поступил на центральный склад Новосибирска"
7: c_given => "AZM24: Отправлен с центрального склада Новосибирска"
8: c_refuse => "AZM24: Отказ поставщика"
9: c_reclamation => "AZM24: Рекламация"
10: c_reclamation_refuse => "AZM24: Отказ в рекламации"
11: c_deducted => "AZM24: Списано с покупателя"
12: c_refuse_manager => "AZM24: Отказ при обработке заказа"