Для этой функции не нужна авторизация. Для подтверждения достоверности источника данных используется хэш, сгенерированный функцией
[Проверка обязательности полей на стороне принимающей данные пока что отключена] Если в наборе переданных значений полей будет отсутствовать хотя бы одно обязательное поле, то данные не будут приняты и будет сообщение об ошибке
Если в наборе переданных значений полей будут поля, которые мы в базу данных не записываем, это не вызовет ошибки
Параметры | в POST: Служебные поля (все обязательные) hash - хэш (спрашивайте разработчика апи о том как сгенерировать хэш) ip - адрес того, что оставил сообщение form_type_id - идентификатор типа формы Поддерживаемые типы форм и наборы полей site - доменное имя сайта на котором было заполнена форма (*) site_url - адрес страницы, с которой была отправлена форма (*) Поля с данными введенными посетителем сайта (все необязательные) subject - тема сообщения name - имя email - Email text - текст сообщения phone - телефон companyId - ID компании, которая будет считаться владельцем этих данных |
Данные, передаваемые в ответе | JSON объект с полями: result - 1 или 0 - данные были добавлены или нет, если данные не добавлены, то error_code: 1 - hash не передан, 2 - неправильное значение hash, 3 - не все обязательные поля заполнены, description: текстовое пояснение |
Пример запроса | curl https://my.plat-forma.com/api/v1/events/feedbackform -d '{"hash": "значение hash", "form_type_id":"3", "ip":"1.1.1.1", "site":"plat-forma.com", "site_url": "https://plat-forma.com/kontakty/", "subject":"тема", "text":"текст","email":"mail@gmail.com","name":"имя"}' |
Состав ответа |
{"result": "1"} |