Вопросы с тегом «api-design»

Например, вы выполняете запрос GET для, users/9но нет пользователя с идентификатором # 9. Какой код ответа лучше? 200 ОК 202 Принято 204 Нет содержимого ошибка 400, неверный запрос 404 Не Найдено

332 rest  http  api-design 

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

301 rest  api-design 

Я хотел бы получить некоторую помощь в обработке странного крайнего случая с разбитым на страницы API, который я создаю. Как и многие API, этот разбивает на большие результаты. Если вы запросите / foos, вы получите 100 результатов (т.е. foo # 1-100) и ссылку на / foos? Page = 2, которая …

288 rest  pagination  api-design 

В отличие от C # IEnumerable, где конвейер выполнения может выполняться столько раз, сколько мы хотим, в Java поток может быть «повторен» только один раз. Любой вызов терминальной операции закрывает поток, делая его непригодным для использования. Эта «особенность» отнимает много энергии. Я думаю, причина этого не техническая. Какие конструктивные соображения …

239 java  java-8  java-stream  api-design 

Имейте в виду, что у меня есть элементарное понимание REST. Допустим, у меня есть этот URL: http://api.animals.com/v1/dogs/1/ А теперь я хочу, чтобы сервер заставлял собаку лаять. Только сервер знает, как это сделать. Допустим, я хочу, чтобы он выполнял задание CRON, которое заставляет собаку лаять каждые 10 минут до конца вечности. …

146 api  rest  url  api-design  restful-architecture 

Я хочу, чтобы мой RESTful API был очень предсказуемым. Как лучше всего решить, когда производить сегментацию данных с использованием URI, а не с помощью параметров запроса. Мне кажется логичным, что системные параметры, поддерживающие разбиение на страницы, сортировку и группировку, должны быть после символа "?" Но как насчет таких полей, как …

142 rest  spring-mvc  restful-url  restful-architecture  api-design 

согласно документации метод String.valueOf(Object obj)возвращает: если аргумент равен null, то строка равна "null"; в противном случае obj.toString()возвращается значение. Но почему, когда я пытаюсь сделать это: System.out.println("String.valueOf(null) = " + String.valueOf(null)); вместо этого бросает NPE? (попробуйте сами, если не верите!) Исключение в потоке "main" java.lang.NullPointerException в java.lang.String. (Неизвестный источник) в java.lang.String.valueOf …

127 java  null  nullpointerexception  overloading  api-design 

Следующий код выдает NullPointerException: int num = Integer.getInteger("123"); Вызывает ли мой компилятор значение getIntegernull, поскольку оно статично? В этом нет никакого смысла! Что творится?

106 java  integer  nullpointerexception  api-design  autoboxing 

Если у вас есть API, и вы являетесь разработчиком из Великобритании с очень международной аудиторией, должен ли ваш API setColour() или setColor() (Возьмем одно слово в качестве простого примера.) Инженеры из Великобритании часто защищают свое «правильное» написание, но можно возразить, что орфография в США является более «стандартной» на международном рынке. …

97 api  naming-conventions  api-design 

У меня есть JSON REST API. Рукопожатие даст вам токен, действительный в течение 15 минут. Все звонки, которые вы делаете в течение этих 15 минут, должны работать нормально. Через 15 минут я возвращаю объект ошибки (включая код, сообщение, success = false), но мне также было интересно, какой код ошибки HTTP …

84 web-services  rest  api-design