С чего начать знакомство с API?
Если вы профессиональный разработчик, перейдите в раздел Начало работы, чтобы познакомиться с основами взаимодействия с API. Для создания расширений без навыков программирования обратитесь к разделу Использование AI.
Что такое API?
API (Application Programming Interface) — это набор методов (команд), которые позволяют внешним сервисам взаимодействовать с аккаунтом в laxo: управлять контактами, сделками, задачами и другими данными, а также создавать собственные расширения и интеграции. По сути, API — это мост между вашим кодом и laxo.
Что такое расширения и интеграции?
Под интеграцией понимается любое взаимодействие внешний системы с laxo, например с помощью API. Интеграции позволяют настроить обмен данными между системами и могут быть размещены на собственном сервере, хостинге или любом другом месте.
Расширения – это полноценные небольшие программы, которые добавляют новый функционал в laxo. Примеры расширений: конструктор форм сбора заявок, интеграция с мессенджерами, создание документов на основе данных сделки.
В отличии от интеграций расширения обычно предоставляют понятный интерфейс для управления. Ближайший аналог расширений – обычные приложения в смартфоне.
В laxo можно создавать свои приватные расширения, а также делиться ими с другими пользователями, в том числе с возможностью монетизации.
Что такое токен?
Токен (идентификатор сессии, ключ) — это уникальный секретный код, который идентифицирует вас при обращении к API laxo. Вы можете управлять токенами в настройках своего аккаунта.
Какой срок жизни токена?
Токен продлевается автоматически на 30 суток при каждом использовании его в запросе к API.
Если токен не был использован ни в одном запросе более 30 суток, то он автоматически удаляется. Для возобновления работы потребуется его перезапуск в настройках вашего аккаунта. Там же вы также можете отозвать действующий токен в случае подозрения на его компрометацию.
API возвращает пустой ответ. Почему?
Обычно API на любой запрос, содержащий ошибку, возвращает ответ с подробной информацией об области и типе ошибки.
Однако в случае отправки запроса с некорректной структурой может быть возвращен ответ с кодом 200 (успех), но без детализации. Такое возможно, если отправить запрос в виде одиночного json-объекта, а не массива объектов.
Посетите раздел Начало работы, чтобы узнать правильную структуру данных для отправки запроса.