Перейти к содержимому
MultiloginБаза знаний

Как использовать строгий режим через API

Используйте строгий режим, если хотите, чтобы Multilogin проверял наличие всех обязательных полей в запросе на создание или обновление профиля.

➡️ Добавьте заголовок X-Strict-Mode: true в API-запрос. Если заголовок не указан, Multilogin использует нестрогий режим и применяет значения по умолчанию там, где это поддерживается.

Если в строгом режиме отсутствует обязательное поле, API возвращает ошибку со списком отсутствующих полей.

Строгий и нестрогий режимы

Строгий режим

При использовании X-Strict-Mode: true API требует явно указывать все поля, необходимые для строгой проверки.

  • Если обязательные поля отсутствуют, возвращается ошибка.
  • В ответе перечисляются поля, которые нужно добавить.
  • Используйте этот режим, если хотите полностью контролировать значения запроса и не полагаться на значения по умолчанию.

Нестрогий режим

Нестрогий режим используется по умолчанию, если X-Strict-Mode не указан.

  • Для поддерживаемых пропущенных полей могут использоваться значения Multilogin по умолчанию.
  • Используйте этот режим, если вам не нужно самостоятельно задавать каждый поддерживаемый параметр.

Когда использовать строгий режим?

Используйте строгий режим, если:

  • Ваша автоматизация должна отправлять явные значения, а не использовать значения Multilogin по умолчанию.
  • Вы хотите получить список всех отсутствующих обязательных полей в одном ответе проверки.
  • Вам нужна единообразная проверка запросов во всех автоматизированных процессах.

Как использовать строгий режим

В Postman откройте “Headers” → добавьте X-Strict-Mode как ключ → укажите true как значение. Если вы не укажете это, API будет использовать нестрогий режим по умолчанию.

Справочник заголовков API: Accept: application/json и логический X-Strict-Mode со значением false по умолчанию.

💡 Что произойдет, если я пропущу поле при использовании строгого режима?

Система вернет подробное сообщение об ошибке, сообщающее, какие поля отсутствуют. Это полезнее, чем получать ошибки для каждого отсутствующего поля по отдельности.

 

Будьте в курсе

Следите за обновлениями, общайтесь и смотрите примеры.

Открыть новостиКанал в TelegramЗадать вопросЧат в TelegramПосмотреть кейсыСообщество в Discord