Перейти к содержимому

Передача и редактирование данных туриста

Заявки созданные по API в CRM будут помечены “Заявка создана по API”

Методы для работы с туристами в заявке

- POST запрос добавления туриста в заявку

https://toursystema.com/org-api/request/create-tourist?request_id=1 GET параметр ID заявки (request_id)

- POST запрос редактирования туриста в заявке

https://toursystema.com/org-api/request/update-tourist?request_id=1&id=134 GET параметры ID заявки (request_id) и ID турист (id)

- POST запрос удаления туриста из заявки

https://toursystema.com/org-api/request/delete-tourist?request_id=1&id=134 GET параметры ID заявки (request_id) и ID туриста (id)

Пример тела запроса для создания и редактирования туриста

json
{
  "first_name": "Иван",
  "last_name": "Иванов",
  "middle_name": "Иванович",
  "phone": "+79990000000",
  "email": "test@test.com",
  "food_restriction": "Вегетарианец",
  "birthday": "1999-09-09",
  "passport": "1234 567890"
}

Параметры для создания и редактирования туриста.

ПараметрОписаниеТип данныхОбязательность
idID заявкиstringНет
first_nameФамилияstringДа
last_nameИмяstringНет
middle_nameОтчествоstringНет
phoneНомер телефонаstringНет
emailДата рожденияdate (YYYY-MM-DD)Нет
birthdayСерия и номер паспорта/номер свидетельства о рожденииstringНет
passportВалютаstringНет
food_restrictionОграничения по питаниюstringНет

Успешный ответ (HTTP 200)

json
{
  "success": true,
  "request_id": 234238,
  "tourist_id": 455
}
Нет прав на создание и редактирование заявки (HTTP 403)
json
{
  "name": "Not Found",
  "message": "У вас нет права на совершение этого действия",
  "code": 0,
  "status": 403
}
Заявка не найдена (HTTP 404)
json
{
  "name": "Not Found",
  "message": "Заявка не найдена",
  "code": 0,
  "status": 404
}
Турист не найден (HTTP 404)
json
{
  "name": "Not Found",
  "message": "Турист не найден",
  "code": 0,
  "status": 404
}

Описание ошибок для валидации каждого параметра

ПараметрВозможные ошибки
first_name- Слишком длинная строка. (>255)
last_name- Необходимо заполнить.
- Слишком длинная строка. (>255)
middle_name- Слишком длинная строка. (>255)
phone- Неверный формат номера телефона.
email- Слишком длинная строка. (>255)
- Не является правильным email адресом.
birthday- Неверная дата рождения
passport- Слишком длинная строка. (>255)
food_restriction- Слишком длинная строка. (>255)