интерфейс проверки

В последнее время мне нужно подключиться к внешнему интерфейсу.Основная функция - проверить, заполнил ли указанный магазин информацию о грузе. Интерфейс примерно такой:

POST https://******/Dealer/CheckCarrier
Heads:Authorization=****,Content-Type=application/x-www-form-urlencoded
Request Body:DealerCode=**,StoreCode=**,BrandCode=**,BuCode=**
Response Body:
{"success":true,"message":"操作成功","data":"OK"}

Я полагаю, что вы знакомы со структурой этого ответа.

Первый вопрос

Когда я получил этот интерфейс, я чувствовал себя немного странно. **Поскольку это интерфейс проверки, результат должен быть истинным или ложным Почему дана строка "ОК"? ** Итак, с сомнениями, я нашел пира А, который предоставил интерфейс.

interface_design_004

Peer A ответил: ** данные не важны, результат проверки считается успешным? **В это время у меня в голове больше вопросительных знаков, я чувствую себя странно, и я не могу сказать, почему.

второй вопрос

Подумав немного, я понял источник этого сомнения — понимание Ответа пиром А отличается от моего. Мне кажется, что какой бы интерфейс ни был,данные - это окончательный результат, а успех - это нормальное завершение вызова..

Возьмите этот интерфейс в качестве примера, пока проверка завершена, указанный магазин не имеет полной информации о доставке, успех должен быть верным.

Когда же тогда ложь? Когда результат проверки не может быть получен нормально по каким-либо причинам, возвращается false, например, входной параметр является недопустимым и хранилище не поддерживается, и эти причины будут помещены в сообщение. Если вызывающая сторона хочет знать, какой это тип исключения, это можно определить, добавив поле кода (я не думаю, что вызывающая сторона должна это знать).

Я ошибался все это время?

Я попытался сообщить об этой проблеме своему сверстнику А, и после кучи чепухи сверстник А, похоже, не понял моих сомнений.

interface_design_002

Может быть, я не совсем ясно выразился, я попытался объяснить это метафорически:Я хочу посмотреть, есть ли мясо наверху? В данных проставляется конечный результат, то есть есть ли мясо, и когда успех верный, то это значит, что я успешно залез на слив и подтвердил, есть ли мясо, когда ложный, может быть, что я упал лестнице. Проверьте, есть ли мясо.

interface_design_003

В конце концов сверстник А, похоже, согласился с моей логикой. Конечно, они могли подумать, что я слишком раздражаю и не хочу со мной разговаривать.

Эпилог

Итак, я хочу знать, как люди понимают Response.

Наконец, спасибо за чтение, и добро пожаловать на общение в личном сообщении.

2021-11-16 Дополнение

14.11.2021 Получил много отзывов после публикации статьи.

Прежде всего, спасибо: в ответ на мои сомнения многие восторженные садоводы высказали свое мнение, благодаря чему я многому научился.

Во-вторых, мне тоже очень жаль: из-за моего некорректного выражения многие путают Response в тексте с HTTP Response. Я добавлю объяснение здесь.

interface_design_005

Эта статья является оригинальной статьей, пожалуйста, прикрепите ссылку на оригинальный источник для перепечатки:Блог Wooooooo.cn on.com/Zhang Z очень…