Запитання з тегом «api-design»

Наприклад, ви запускаєте GET-запит, users/9але немає користувача з ідентифікатором №9. Який найкращий код відповіді? 200 ОК 202 Прийнято 204 Немає вмісту 400 Поганий запит 404 Не знайдено

331 rest  http  api-design 

Наскільки я можу сказати, кожен окремий ресурс повинен мати лише один канонічний шлях. Отже, у наступному прикладі, які б гарні шаблони URL-адрес були? Візьмемо для прикладу представлення компаній про відпочинок. У цьому гіпотетичному прикладі кожна компанія має 0 або більше відділів, і кожен відділ має 0 і більше працівників. Департамент …

301 rest  api-design 

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

288 rest  pagination  api-design 

На відміну від C # 's IEnumerable, де конвеєр виконання може бути виконаний стільки разів, скільки ми хочемо, в Java потік можна "повторити" лише один раз. Будь-який дзвінок до операції терміналу закриває потік, роблячи його непридатним. Ця 'особливість' забирає багато сил. Я думаю, що причина цього не є технічною. Які …

239 java  java-8  java-stream  api-design 

Майте на увазі, що я розумію REST. Скажімо, у мене є така URL-адреса: http://api.animals.com/v1/dogs/1/ А тепер я хочу змусити сервер зробити собачий гавкіт. Тільки сервер знає, як це зробити. Скажімо, я хочу, щоб він працював на роботі CRON, що змушує собаку брахати кожні 10 хвилин протягом усієї вічності. Як виглядає …

142 api  rest  url  api-design  restful-architecture 

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

141 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. (невідоме …

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() (Візьмемо одне слово як простий приклад.) Британські інженери часто досить захисно ставляться до своїх "правильних" написань, але можна стверджувати, що правопис США є більш "стандартним" на міжнародному ринку. Я …

93 api  naming-conventions  api-design 

У мене є JSON REST API. Існує рукостискання, яке дасть вам маркер, дійсний протягом 15 хвилин. Усі дзвінки, які ви робите протягом цих 15 хвилин, повинні працювати нормально. Через 15 хвилин я повертаю об'єкт помилки (включає код, повідомлення, успіх = false), але мені також цікаво, який код помилки HTTP я …

84 web-services  rest  api-design