Ваш первый коннектор

Нужны Node.js 22 или новее, curl и shasum (macOS и Linux). Каждая команда ниже — из пустой папки, без репозитория платформы и без переменных окружения. Тот же порядок прогоняет наш тест.

1. Пакет проверки

Скачайте пакет набора 4 и сверьте сумму: она должна сойтись до первого запуска.

mkdir -p yandex-express && cd yandex-express
curl -fsSLo dala-connector-kit.mjs https://build.zengi.ai/developers/kit/v4/dala-connector-kit.mjs
echo "e695b0d3f57a7ca6228bbe00d91b4a286d35d4d1266e926e8d7dea68135f82a8  dala-connector-kit.mjs" | shasum -a 256 -c -

2. Рабочий образец

Пакет печатает образец в форме файла публикации: манифест и кассеты. Разложите его по файлам — манифест рядом, кассеты по путям из contract_tests.

node dala-connector-kit.mjs sample yandex_express > sample.json
node -e 'const fs = require("fs"), path = require("path");
  const body = JSON.parse(fs.readFileSync("sample.json", "utf8"));
  fs.writeFileSync("manifest.json", JSON.stringify(body.manifest, null, 2));
  for (const [file, cassette] of Object.entries(body.cassettes)) {
    fs.mkdirSync(path.dirname(file), { recursive: true });
    fs.writeFileSync(file, JSON.stringify(cassette, null, 2));
  }'

3. Проверка

Код выхода 0 и строка ЗЕЛЁНЫЙ — проверка пройдена; 1 — красная, строки с ✖ называют, что править; 2 — неверный вызов.

node dala-connector-kit.mjs conformance manifest.json

4. Файл для владельца компании

При зелёной проверке пакет собирает файл публикации. В нём — манифест, кассеты и номер набора пакета.

node dala-connector-kit.mjs bundle manifest.json > connector.json

Отдайте connector.json владельцу компании: он загрузит его в «Интеграциях». Свою систему описывайте так же — по образцу, меняя операции и кассеты; на поля манифеста подскажут строки ✖ проверки.

Свой коннектор с агентом — команда «новый коннектор».