Что нового​

В следующие эндпоинты добавлены:

• Параметр sort для управления порядком вывода данных
• Параметры фильтрации по датам для точной выборки записей

Затронутые эндпоинты:

• GET /api/v1/contragents/ — список контрагентов
• GET /api/v1/payments/ — список платежей
• GET /api/v1/docs_sales/ — список документов продаж
• GET /api/v1/nomenclature/ — список номенклатуры
• GET /api/v1/loyality_cards/ — список карт лояльности

Параметр sort​

Параметр sort принимает следующие значения:

Параметры фильтрации по датам​

Для точной выборки записей по временным диапазонам доступны следующие параметры:

Примеры использования​

Получение последних созданных контрагентов​

GET https://app.tablecrm.com/api/v1/contragents/?sort=created_at:desc

Этот запрос вернёт список контрагентов, отсортированных по дате создания от новых к старым.

Получение платежей по дате обновления​

GET https://app.tablecrm.com/api/v1/payments/?sort=updated_at:asc

Получение платежей, отсортированных по дате последнего обновления от старых к новым.

Сортировка документов продаж​

GET https://app.tablecrm.com/api/v1/docs_sales/?sort=created_at:desc&limit=50

Получение последних 50 документов продаж.

Номенклатура по давности обновления​

GET https://app.tablecrm.com/api/v1/nomenclature/?sort=updated_at:desc

Полезно для отслеживания недавно измененных товаров.

Карты лояльности​

GET https://app.tablecrm.com/api/v1/loyality_cards/?sort=created_at:asc

Получение карт лояльности в порядке их создания.

Фильтрация контрагентов по дате создания​

GET https://app.tablecrm.com/api/v1/contragents/?created_at__gte=1696723200&created_at__lte=1699315200

Получение контрагентов, созданных с 8 октября по 7 ноября 2023 года.

Фильтрация платежей по дате обновления​

GET https://app.tablecrm.com/api/v1/payments/?updated_at__gte=1699315200

Получение всех платежей, обновленных после 7 ноября 2023 года.

Комбинирование сортировки и фильтрации​

GET https://app.tablecrm.com/api/v1/docs_sales/?created_at__gte=1696723200&sort=created_at:desc&limit=100

Получение последних 100 документов продаж, созданных после 8 октября 2023 года, отсортированных от новых к старым.

Диапазон обновлений номенклатуры​

GET https://app.tablecrm.com/api/v1/nomenclature/?updated_at__gte=1696723200&updated_at__lte=1699315200&sort=updated_at:desc

Получение товаров, обновленных в указанном диапазоне дат.

Поведение по умолчанию​

Если параметр sort не указан, данные возвращаются отсортированными по дате создания от новых к старым (created_at:desc).

Преимущества​

✅ Удобная аналитика — легко отслеживайте последние изменения
✅ Гибкая выборка — получайте данные в нужном порядке
✅ Точная фильтрация — выбирайте записи по временным диапазонам
✅ Оптимизация работы — сократите время на обработку данных на стороне клиента
✅ Совместимость — параметры опциональные, существующие интеграции продолжат работать без изменений

Обратная совместимость​

Изменения полностью обратно совместимы. Если параметры sort и фильтрации по датам не указаны, API будет работать как прежде.

Если у вас возникли вопросы по использованию нового функционала, обращайтесь в нашу поддержку или изучите полную документацию API.

Хорошей работы с TableCRM! 🚀

Что нового​

• Обновлены все зависимости до последних версий
• React 18
• Node.js 20
• Современные инструменты разработки

Основные улучшения​

• Улучшенная производительность
• Лучшая совместимость
• Обновленная система тем