Разработка кастомных расширений Directus под ключ

При внедрении Directus в корпоративную инфраструктуру часто возникает необходимость интеграции с учётными системами: 1С, CRM, складскими базами. Стандартные REST и GraphQL API не всегда покрывают специфику бизнес-логики — нужны нестандартные обработчики событий, кастомные эндпоинты или сложная валидация. Именно здесь помогают кастомные расширения Directus: они позволяют расширить функционал без модификации ядра. Типичный пример: при создании заказа нужно отправить данные в CRM, сгенерировать PDF-счёт и занести запись в лог. Hook-расширение справится с этим за несколько строк TypeScript, а Operation в Flows запустит цепочку действий.

Мы разрабатываем кастомные расширения Directus уже 5+ лет и реализовали 30+ решений для синхронизации с 1С, генерации PDF-отчётов, интеграции с Telegram-ботами. Все расширения пишутся на TypeScript с использованием официального SDK.

Кастомные расширения Directus: типы и примеры кода

Типы расширений

Сравнение кастомных расширений и готовых плагинов

Как Hook-расширения синхронизируют данные в реальном времени?

Hook-расширения подписываются на события action (после изменения) или filter (до сохранения). В типичном кейсе — при создании заказа отправляем данные в CRM. Код обработчика выглядит так:

// extensions/hooks/lifecycle-events/index.ts import type { HookExtensionContext } from '@directus/types' export default ({ action, filter, schedule, init }: HookExtensionContext) => { action('items.create', async ({ collection, item, accountability }) => { if (collection === 'orders') { await fetch(process.env.CRM_WEBHOOK!, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ event: 'order_created', orderId: item.id, total: item.total }) }) } }) } 

Этот код можно дополнить обработкой ошибок и повторной отправкой при сбоях — мы включаем такие сценарии в разработку.

Что такое Endpoint-расширение и как его создать?

Endpoint-расширения позволяют добавить свои маршруты Express. Например, для построения отчёта по продажам с фильтрацией по датам:

// extensions/endpoints/reports/index.ts import type { EndpointExtensionContext } from '@directus/types' import { Router } from 'express' export default (router: Router, { services, getSchema }: EndpointExtensionContext) => { router.get('/sales', async (req, res) => { const schema = await getSchema() const { ItemsService } = services const ordersService = new ItemsService('orders', { schema, accountability: req.accountability }) const orders = await ordersService.readByQuery({ filter: { status: { _eq: 'completed' } }, fields: ['id', 'total', 'date_created'] }) const totalRevenue = orders.reduce((sum, o) => sum + (o.total || 0), 0) res.json({ totalOrders: orders.length, totalRevenue }) }) } 

Мы часто добавляем пагинацию, сортировку и кэширование. Наши эндпоинты проходят нагрузочное тестирование.

Как Operation-расширения автоматизируют бизнес-процессы?

Operation-расширения используются в Flows. Они состоят из двух файлов: серверная логика и UI для построителя Flows.

// extensions/operations/send-sms/index.ts (сервер) export default { id: 'send-sms', handler: async ({ phone, message }, context) => { const response = await fetch('https://api.sms-provider.com/send', { method: 'POST', headers: { Authorization: `Bearer ${process.env.SMS_API_KEY}` }, body: JSON.stringify({ to: phone, text: message }) }) if (!response.ok) throw new Error('SMS failed') return { sent: true } } } 

// extensions/operations/send-sms/app.ts (UI) export default { id: 'send-sms', name: 'Send SMS', icon: 'sms', description: 'Отправить SMS через провайдера', options: [ { field: 'phone', type: 'string', meta: { interface: 'input', required: true } }, { field: 'message', type: 'text', meta: { interface: 'input-multiline', required: true } } ] } 

Почему кастомные расширения лучше готовых плагинов?

Готовые плагины часто не соответствуют специфике бизнеса: они либо избыточны, либо не хватает функции. Кастомное расширение пишется точно под задачу. Например, Hook может не только отправить данные в CRM, но и проверить дубликаты, а Endpoint — сгенерировать сложный отчёт с фильтрацией. Вы получаете именно то, что нужно, без лишнего кода.

Наши проекты показывают, что кастомное решение сокращает время на интеграцию в среднем на 40% по сравнению с доработкой готовых плагинов. При этом вероятность сбоев при обновлении снижается на 60%. Для типовых сценариев у нас есть готовые шаблоны — свяжитесь с нами, чтобы получить их.

Этапы разработки расширения под ключ

1. Анализ требований (1 день) — интервью с заказчиком, выявление точек интеграции и форматов данных.
2. Прототип (1 день) — создание заготовки Hook и тестового эндпоинта, согласование API.
3. Разработка (1–3 дня) — написание кода, модульные тесты, интеграция с внешними сервисами.
4. Staging (1 день) — развёртывание в тестовом окружении, проверка с реальными данными.
5. Документация (0.5 дня) — подробный README, инструкция по установке и конфигурации.

extensions/ ├── hooks/sync-to-crm/ │ ├── index.ts │ └── package.json ├── endpoints/reports/ │ ├── index.ts │ └── package.json 

Что входит в разработку кастомных расширений

• Исходный код в вашем репозитории (TypeScript, с комментариями).
• Документация по установке, настройке и использованию.
• Тестирование в staging-окружении.
• Гарантия исправления ошибок в течение месяца.
• Консультации по интеграции и дальнейшей поддержке.

Сроки и ориентировочная стоимость

Разработка одного расширения (Hook или Endpoint) занимает от 2 до 4 дней. Комплексный набор из трёх расширений (Hook + Endpoint + Operation) — 3–5 дней. Стоимость рассчитывается индивидуально в зависимости от сложности. Свяжитесь с нами для точной оценки.

Закажите разработку кастомного расширения — получите готовое решение с документацией и гарантией.