Зелёные галочки и два чека
Специалист собрал сценарий приёма оплат: платёжный сервис сообщает об успешном платеже, сценарий помечает заказ оплаченным и выписывает чек. В конструкторе всё зелёное, тестовый платёж прошёл. Он ушёл на выходные.
В понедельник его ждали задвоенные чеки. Ничего не сломалось: платёжный сервис честно повторил уведомление, потому что так он устроен, а сценарий честно выписал второй чек, потому что его никто не научил отличать повтор от нового события.
Конструктор рисует стрелочки поверх двух механизмов — запроса к API и вебхука. Стрелочки прячут их настолько удачно, что сценарий собирается методом тыка и работает. Ровно до первого сбоя, который надо чинить.
Здесь разбирается, как эти два механизма устроены на самом деле: из чего состоит запрос, что означает ответ, чем ключ доступа отличается от пароля (ничем), почему вебхук приходит дважды и что с этим делают.
Программировать не придётся и не понадобится: задача специалиста по no-code — читать документацию и настраивать готовые коннекторы. Именно этому здесь и учат.
Написать собственную интеграцию после этой лекции вы не сможете — и не должны. Это работа разработчика.
Зато сможете открыть документацию незнакомого сервиса и за двадцать минут понять, как он авторизует, что он присылает и где у него грабли.
Шестнадцать тем и сорок два вопроса. К персонажу с двумя чеками мы вернёмся в конце — с тем же сценарием, но починенным.
API — это договор, а не программирование
API — это описанный заранее договор о том, как один сервис спрашивает другой. У договора четыре части: адрес (куда стучаться), метод (что за действие), параметры (с какими данными) и ответ (что вернётся). Всё, что делает коннектор в вашем конструкторе, — заполняет эти четыре поля за вас.
| Часть договора | Что она значит |
|---|---|
| Адрес | Куда идёт запрос. Обычно склеен из домена сервиса, пути к API и имени метода |
| Метод | Что именно вы просите сделать: прочитать, создать, заменить, удалить |
| Параметры | Данные запроса: идентификатор записи, поля новой сделки, номер страницы |
| Ответ | То, что вернулось: код состояния и тело ответа с данными или описанием ошибки |
Как это выглядит в вашей работе
Форма на сайте собрала заявку. Коннектор берёт поля формы, складывает из них параметры и отправляет запрос в CRM: «создай сделку». CRM отвечает — либо «создал, вот её номер», либо «не создал, вот почему». Между «отправил» и «создал» лежит вся эта лекция.
Тело запроса и ответа сервисы почти всегда пересылают в формате JSON — это обычный текст, у которого есть именованные поля. Здесь важно только то, что стороны заранее договорились о формате конверта. Что положить в конкретное поле и как соотнести поля двух сервисов — отдельная большая тема, и она разбирается не здесь.
Документация API — не справочник для разработчика, а текст договора, который вы подписываете за компанию. Коннектор избавляет от синтаксиса, но не от чтения.
Дальше нужен аккаунт
Прогресс и монеты сохранятся.