Рекомендації щодо роботи з параметрами запитів
Важливо: Якщо параметр не є обов'язковим, рекомендується не передавати його у запиті взагалі. У разі передачі необов'язкового параметра система автоматично застосовує до нього валідацію, зокрема:
Перевірку на відсутність значення (
null
);Відповідність специфікації (формат, тип даних, діапазон значень тощо).
Наслідки:
Якщо клієнт передає необов'язковий параметр зі значенням null
або у невірному форматі, система поверне помилку валідації, що може призвести до відмови обробки запиту.
Рекомендації для клієнтів:
Уважно перевіряйте передавані параметри, звертаючи увагу на:
Обов'язковість параметра (позначено у документації як обов'язкові або не обов'язкові);
Очікуваний тип даних та формат (наприклад,
string
,ISO 8601 timestamp
).
Для необов'язкових параметрів:
Пропускайте параметр у запиті, якщо він не використовується;
Уникайте передачі явних
null
або порожніх значень.
Last updated