Мы используем стандарт JSON-API для разработки нашего API, и мы столкнулись с проблемой, которая не имеет очевидного решения в соответствии со стандартом, как кажется.
Вариант использования следующий:
Существует конечная точка API, которая позволяет вам подписываться на списки рассылки. Один из возможных вариантов заключается в том, что пользователь добавляется как ОЖИДАНИЕ, что означает, что пользователь получит электронное письмо для подтверждения и подтвердит его.
Если это так, мы хотим вернуть внешнему интерфейсу сообщение, которое может отображаться пользователю, призывая его щелкнуть ссылку.
С моей точки зрения, это на самом деле не состояние ошибки, а дополнительная метаинформация. Таким образом, это означает, что концептуально нелогично помещать его в сообщения об ошибках. Кроме того, если мы помещаем его в сообщения об ошибках, интерфейс должен каким-то образом отличать его от «настоящих ошибок» (статус-коды имеют такое низкое разрешение, что коллизии кажутся неизбежными).
Однако мы не возвращаем ресурс, поэтому мы не можем добавить его в качестве метаинформации к ресурсу. Так что прямо сейчас я понятия не имею, куда поместить эту информацию.
Одним из возможных решений было бы определить какой-то ресурс «Ответ» и поместить его туда, но это просто похоже на банку с червями.
Любые идеи? Ввод был бы очень ценен