REST API

Что это значит

REST API - самый распространённый стиль веб-интерфейса, через который системы обмениваются данными с помощью стандартных HTTP-запросов, чаще всего в формате JSON. У каждого объекта, например счёта или клиента, есть свой адрес, а с данными работают операциями чтения, создания, изменения и удаления.

Это конкретная форма API, которая закрепилась благодаря простоте и независимости от языка программирования. Через REST API связывают интернет-магазин с бухгалтерской программой, банк с корпоративной системой, CRM с инструментом рассылок или программу выставления счетов с платёжным шлюзом.

Безопасность обеспечивают шифрованное соединение и проверка доступа, например API-ключом или токеном. Дополнением к REST API часто служит вебхук, через который система сама сообщает о событии, например оплате счёта, вместо того чтобы другая система постоянно спрашивала.

Как это работает на практике

При выборе бухгалтерской или программы выставления счетов стоит проверить, есть ли у неё документированный REST API и что через него можно делать. Интеграция магазина с бухгалтерией через API избавляет от ручного ввода заказов и счетов и снижает число ошибок.

Интеграцию должен проектировать тот, кто понимает обе системы и правила учёта. Важно определить, какая система - источник истины для конкретных данных, как обрабатываются ошибки и дубли и как изменения проверяются перед запуском.

При связи с банком REST API используют в рамках открытого банкинга для загрузки выписок или создания платежей. Бухгалтерская фирма может получать движения по счёту автоматически и сопоставлять их со счетами, не дожидаясь месячной выписки.

На что обратить внимание

API-ключи и токены - как пароли. Если они попадут в публичный код, письмо или таблицу, любой получит доступ к данным. Ключи хранят надёжно, дают им только необходимые права и при подозрении на утечку немедленно меняют.

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