Вам нужно посмотреть на то, что вы пытаетесь сделать.
API имеет работу, чтобы получать запросы и предоставлять ответы. Создание всплывающих окон - это не то, что имеет смысл в контексте API.
Клиенты, использующие API, могут даже не иметь возможности работать с JavaScript. Вы можете вызвать API из консольного приложения или стороннего инструмента.
Предоставление пользователю информации о том, чего не хватает, предположительно о некоторых свойствах модели вызова, осуществляется с помощью ответа, вы отправляете неверный запрос с подробной информацией, почему, ожидая, что пользователь исправит свои данные вызова и попытается повторить вызов.