Файловый обмен v.1
Обратите внимание! Файловый обмен v.1 не поддерживается с 30 марта 2018 года. ФУДКОСТ не гарантирует актуальность данных, полученных с использованием этого метода!
Все подключение к данным производится через HTTPS–запросы к URL https://foodcost.pro/personal/exchange/, с некоторым набором параметров. В ответ на запрос вы получаете его результат в формате XML, который также описан в документации.
Параметры запроса
В каждом запросе должен присутствовать набор обязательных параметров. Также для каждого файла в его документации определены дополнительные параметры, нужные только для его получения. Текстовые значения параметров должны быть переданы в кодировке UTF–8. Одинаковые для всех функций параметры перечислены ниже.
| Параметр | Обязательный | Описание |
|---|---|---|
| LOGIN | Да | Логин пользователя на FOODCOST к которому привязана компания. |
| PASSWORD | Да | Пароль пользователя на FOODCOST к которому привязана компания. |
| KEY | Да | Ключ интеграции, получаемый пользователем после активации подписки на FOODCOST и к которому привязана компания. |
| KEY_SESSION | Да | Идентификатор сессии получается при каждом новом сеансе работы пользователя с вашим приложением. При последующих заходах того же пользователя это значение будет другим, поэтому его нужно сохранить для последующей авторизации. |
| file | Да | Тип данных, доступ к которым требуется получить. |
Внимание! При формировании запроса, названия параметров должны быть написаны прописными или строчными буквами так, как указано в настоящей документации.
Порядок следования параметров в запросе значения не имеет.
Первая авторизация
При первой авторизации на сервере, клиент формирует запрос, в котором передает:
- LOGIN
- PASSWORD
- KEY
- file
Пример запроса при первой авторизации
https://foodcost.pro/personal/exchange/?LOGIN=user&PASSWORD=qWerTy&KEY=UHui9B7zAST4AAK9&file=ingredient
Пример ответа в формате XML
<session_authorize>
<session_id value="6HHruUiXtYTfbpc5bNvVA7iFZ16TNOzv"/>
<reg_key value="2199003694315"/>
</session_authorize>
Демонстрационные данные
Для того, чтобы конечные пользователи смогли оценить качество сервиса, мы подготовили файлы с демонстрационными данными.
Доступ к демоданным не требует регистрации или авторизации. Благодаря этому есть возможность организовать демонстрацию выгрузки данных в систему учёта.
Для загрузки демоданных используйте следующие ссылки:
- Продукты:
https://foodcost.pro/partners/support/ingredients.xml
или https://foodcost.pro/personal/exchange/demo/v.1/products.xml - Блюда и заготовки:
https://foodcost.pro/partners/support/dish.xml
или https://foodcost.pro/personal/exchange/demo/v.1/dish.xml
