Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
api [2020/02/27 07:45] timofeev |
api [2024/09/13 09:26] (текущий) timofeev |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== API Водяного ====== | ====== API Водяного ====== | ||
- | <code>ip-адрес Водяного:10400/api?token=секретный ключ&action=команда¶m={...}</code> | + | <code>ip-адрес Водяного:10400/api?token=секретный_ключ&action=команда¶m={...}</code> |
Здесь команда — команда API;\\ | Здесь команда — команда API;\\ | ||
параметры команды задаются в формате json (имя_параметра:значение параметра разделенные точкой с запятой).\\ | параметры команды задаются в формате json (имя_параметра:значение параметра разделенные точкой с запятой).\\ | ||
token — ключ доступа, задается в поле "пароль" [[параметры_интеграции|справочника интеграций]], например qwerty12345\\ | token — ключ доступа, задается в поле "пароль" [[параметры_интеграции|справочника интеграций]], например qwerty12345\\ | ||
+ | Токен может быть указан как в url запроса, так и в заголовке 'Authorization: Bearer секретный_ключ'.\\ | ||
+ | Примечание: Для работы с API должен быть "проброшен" во внешнюю сеть порт 10400 сервера, где установлена база данных и установлен на этом сервере Водяной в режиме службы.\\ | ||
+ | |||
Все ответы передаются в кодировке UTF-8, запросы ожидаются в той же кодировке.\\ | Все ответы передаются в кодировке UTF-8, запросы ожидаются в той же кодировке.\\ | ||
- | Ниже приведены описания возможных команд | + | Ниже приведены описания команд: |
- | [[API_zagr_tov|Загрузка списка товаров во внешнюю систему (zagr_tov)]] | + | |
+ | [[API_spistov|Загрузка списка товаров во внешнюю систему (spistov)]] | ||
+ | |||
+ | [[API_zakaz|Формирование предварительной заявки (zakaz)]] | ||
+ | |||
+ | [[API_platkart|Платеж картой]] | ||
+ | |||
+ | [[API_statusz|Получение статуса заказа (statusz)]] | ||
+ | |||
+ | [[API_otmenaz|Отмена заказа (otmenaz)]] | ||
+ | |||
+ | [[API_posledz|Последние заказы (posledz)]] | ||
+ | |||
+ | [[API_dolg|Получение данных о долге (предоплате)]] | ||
+ | |||
+ | [[API_spr|Чтение справочников]] | ||
+ | |||
+ | [[API_doc|Чтение документов]] | ||
- | [[API_zagr_tov|Прием заказа (zakaz)]] | ||
+ | Кроме описанной версии API, доступен [[rest|REST-вариант]]. | ||
- | === Получение статуса заказа (GET) === | ||
- | <code>ip-адрес Водяного:10400/api?token=секретный ключ&action=statusz¶m={...}</code> | ||
- | параметры: id – номер заказа, под которым он был создан во внешней системе (на сайте) и отправлен в программу\\ | ||
- | ответ: состояние заказа в виде числа\\ | ||
- | возможные варианты:\\ | ||
- | 9999 — заказ отсутствует в системе\\ | ||
- | 0 — записан (пришел с сайта)\\ | ||
- | 1- принят (обработан оператором, создана расходная накладная), но еще не назначен экспедитору/водителю\\ | ||
- | 2 — отправлен экспедитору, но еще не дошел до него, такой статус в нормальной ситуации (при использовании мобильного приложения) может сохраняться не более минуты\\ | ||
- | 3 - у экспедитора (пришел на планшет, телефон)\\ | ||
- | 4 — выполнен\\ | ||
- | 5 - не удалось выполнить\\ | ||
- | 6 - отменен клиентом\\ | ||
- | Пример: <code>4.4.4.4:10400/api?token=aaabbb123456&action=statusz¶m={”id”:”12356”}</code>\\ | ||
- | Ответ: 3\\ | ||
- | (заказ получен экспедитором, выполняется).\\ | ||