Перейти к содержанию

Ларди Транс API

Условия использования Lardi-Trans API и ограничение ответственности

  1. Lardi-Trans API (далее Lardi-Trans АРІ или АРІ) предоставляется на условиях «как есть» (as is).
  2. Разработчики АРІ четко и однозначно уведомляют любого пользователя о том, что они не предоставляют гарантии того, что Lardi-Trans API будет соответствовать Вашим требованиям, а также что в процессе работы АРІ не будут возникать прерывания или ошибки, а также не гарантируют работоспособность ни АРІ в целом, ни отдельных функций АРІ ни на данный момент, ни в будущем.
  3. Lardi-Trans АРІ находится в активной разработке, поэтому разработчики АРІ четко и однозначно уведомляют любого пользователя АРІ о том, что изменения кода, алгоритмов, методов, форматов ответов и любых других функций и элементов Lardi-Trans АРІ производится постоянно и без предварительного согласования с пользователями, а также без уведомления пользователя о внесенных изменениях.
  4. Вы несете ответственность за любое использование Lardi-Trans АРІ, которое позволит Вам достичь намеченных результатов, а также ответственность за результаты, которые будут достигнуты благодаря использованию Lardi-Trans АРІ. Исключительно пользователи АРІ несут все риски, связанные с качеством, производительностью и работоспособностью Lardi-Trans АРІ.
  5. Ни в каких случаях разработчики АРІ не несут ответственности перед пользователями Lardi-Trans АРІ или любыми третьими лицами за любые сопутствующие, случайные, косвенные, фактические, типовые или штрафные убытки или упущенную выгоду, даже если разработчики были предварительно осведомлены о возможности таких убытков.
  6. Использование Lardi-Trans API подразумевает полное согласие пользователя с указанными правилами использования Lardi-Trans API и ограничением ответственности.

Техническая информация

  • Lardi-Trans API это RESTful сервис для разработчиков, с помощью которого можно программно взаимодействовать с продуктами Lardi-Trans.

  • Lardi-Trans API построен по принципам REST, все данные, которыми обмениваются клиент и API, это JSON по HTTPS протоколу.

  • Базовый адрес для Lardi-Trans API это https://api.lardi-trans.com/v2

Авторизация

  • Все запросы на API должны содержать HTTP header с вашим уникальным ключом (токеном). Например:
Authorization: 2UL4BXx01wU000000025

Вместо токена2UL4BXx01wU000000025 вам нужно подставить ваш собственный. Работа со своими токенами доступна на сайте в разделе Безопасность.

Язык

Для получения результата на желаемом языке нужно указать его в параметре language, например - ?language=uk. По умолчанию это русский (ru).

Ошибки

  • Lardi-Trans использует коды состояния HTTP для индикации результата запроса. Коды в диапазоне 2хх говорят об успешном запросе, в диапазоне 4хх указывают на ошибку запроса (отсутствует обязательный параметр запроса, запрошенный ресурс не существует и т.д.), а коды в диапазоне 5хх сигнализируют об ошибках самого сервиса.
Код Статус Описание
200 OK Запрос отработал успешно
201 Created Ресурс создан успешно
400 Bad Request Неверный запрос(отсутствует обязательный параметр)
401 Unauthorized Не указан уникальный ключ клиента или указанный ключ не найден
403 Forbidden Доступ запрещен
404 Not Found Ресурс не найден
422 Unprocessable Entity Запрос не может быть обработан по причине логической несовместимости переданных данных
429 Too Many Requests Клиент отправляет слишком много запросов
50* Server Errors Произошла ошибка на стороне сервера