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

48
Почему метод PATCH не идемпотентен?

Мне было интересно об этом. Предположим , у меня есть userресурс с idи nameполей. Если я хочу обновить поле, я мог бы просто сделать запрос PATCH к ресурсу, как это PATCH /users/42 {"name": "john doe"} И тогда приложение обновит имя пользователя 42. Но почему, если я повторю этот запрос, результат...

44
Как правильно сделать сложный метод поиска RESTful?

Следуя принципам REST, я бы хотел создать метод GET для моего API, который выполняет поиск по некоторым критериям и возвращает результаты клиенту. Проблема в том, что критерии могут иметь до 14 параметров, один из которых - список сложных объектов, поэтому ... Я даже не знаю, возможно ли кодировать...

42
Что такого плохого в DOM?

Я продолжаю слышать, как люди (в частности, Крокфорд) говорят, что DOM - ужасный API, но на самом деле не оправдывают это утверждение. Помимо кросс-браузерных несоответствий, по каким причинам DOM считается настолько...

42
Является ли производительность единственной причиной не использовать SignalR (websockets) полностью вместо традиционного REST API?

Я использовал SignalRдля достижения функциональности обмена сообщениями в реальном времени в нескольких из моих проектов. Кажется, он работает надежно и очень прост в освоении. Искушение, по крайней мере для меня, состоит в том, чтобы отказаться от разработки сервиса Web API и использовать его...

38
На самом деле стоит модульное тестирование клиента API?

Это то, что беспокоило меня некоторое время. На самом деле стоит модульное тестирование клиента API? Допустим, вы создаете небольшой класс, чтобы абстрагировать вызовы API-интерфейса REST. PetShop - очень простой API, и у него есть базовый набор методов: listProducts() getProductDetails(ProductID)...

37
Как я могу препятствовать совместному использованию внутренних ключей API внутри компании?

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

36
Как определить, что метод может быть переопределен более сильным обязательством, чем определение, что метод может быть вызван?

От: http://www.artima.com/lejava/articles/designprinciples4.html Эрих Гамма: Я все еще думаю, что это правда, даже после десяти лет. Наследование - это крутой способ изменить поведение. Но мы знаем, что это хрупко, потому что подкласс может легко делать предположения о контексте, в котором...

33
Должны ли мы вызывать Web API из приложения MVC в том же решении?

Я работаю над проектом в MVC, в котором есть мобильное приложение, поэтому ясно одно, что мы должны использовать веб-API, чтобы его можно было использовать в мобильном приложении. После создания API, когда мы начали разрабатывать веб-сайт, мы растерялись и обсуждали, использовать ли API или иметь...

33
Почему нет поддержки типа WSDL для Web Api?

Поэтому я только начинаю работу с .Net WebApi, и сразу замечаю, что не существует Контракта, определяющего, как API выглядит и должен потребляться (Запрос / Ответ от каждого Действия), обычно это происходит в форме WSDL для WCF / Мыло. Мне кажется, что это что-то очень ценное и облегчит жизнь...

33
Как я могу написать набор функций, которые могут быть вызваны из (почти) любого языка программирования?

Я хотел бы найти способ написать API, к которому можно получить доступ из любого другого языка программирования через привязки языка (или некоторую другую структуру). Можно ли это сделать? Если да, то какой язык программирования будет наиболее подходящим для написания «междисциплинарного» API? Моя...

32
почему люди делают REST API вместо DBAL?

В прошлых двух компаниях, в которых я работал в REST API, существовал запрос данных через веб-приложение. то есть. вместо того, чтобы веб-приложение выполняло SQL напрямую, оно вызывает REST API, которое выполняет SQL и возвращает результат. Мой вопрос ... почему это сделано? Если бы это собиралось...

32
Должен ли я проверить, существует ли что-то в БД и быстро потерпеть неудачу, или дождаться исключения БД

Имея два класса: public class Parent { public int Id { get; set; } public int ChildId { get; set; } } public class Child { ... } При назначении ChildIdна Parentя должен проверить первый , если он существует в БД или ждать DB бросить исключение? Например (с использованием Entity Framework Core):...

32
Как представить (перечислить) типы в публичном API

Я работаю над простым API-интерфейсом, который хочу использовать для собственного клиента и который будет открыт для публики в будущем. У меня есть объекты «Предмет», которые могут иметь разные «типы». Тип является C "typedef enum", на данный момент у меня есть: typedef enum { ItemTypeBool,...

31
Должен ли сайт использовать собственный публичный API?

Я начинаю писать веб-сервис, и я создал с помощью nodeJS и подходом RESTfulish. Из того, что я собираю: Преимущество в том, что вам не нужно дублировать код. Недостатки в том, что вы: будет часто обновлять публичный API, но должен решаться с помощью версий не может реально сделать сервис...

29
Наименование интерфейса: префикс 'Can-' vs суффикс '-Able'

Обычно в качестве суффикса для интерфейсов используется «-able», например Сериализуемый Печатный Enumerable Питьевой Shootable Вращающийся Я думал, что «может» может быть лучше, потому что это может быть более наглядным. Да, это более многословно, и это добавляет шум к имени интерфейса. В...

27
API REST на основе ролей?

Я создаю REST API, для которого несколько пользователей с разными ролями будут иметь доступ к содержащимся в нем ресурсам. Для простоты, давайте возьмем домен "ученик / учитель / класс": GET /students ресурс для доступа. У пользователей могут быть роли, такие как Студент и / или Учитель Студенты...

27
Почему в соглашении говорится, что имена таблиц БД должны быть единичными, а ресурсы RESTful - множественными?

Это довольно устоявшееся соглашение, что имена таблиц базы данных, по крайней мере в SQL, должны быть единичными. SELECT * FROM user;Смотрите этот вопрос и обсуждение . Это также довольно устоявшееся соглашение о том, что имена ресурсов API RESTful должны быть множественными. GET /users/123и POST...

26
Методы аутентификации веб-API

У нас есть платформа веб-службы MVC asp.net для предоставления xml / json людям. Получайте запросы, но изо всех сил пытаемся найти лучший способ (быстрый, простой, тривиальный для пользователей, кодирующих на языках javascript или OO) для аутентификации пользователей. Дело не в том, что наши данные...

25
Дизайн API: конкретный или абстрактный подход - лучшие практики?

При обсуждении API-интерфейсов между системами (на бизнес-уровне) в нашей команде часто бывают две разные точки зрения: некоторые люди предпочитают более общий, скажем так, общий абстрактный подход, а другие - прямой «конкретный» подход. Пример: дизайн простого API «поиск человека». конкретная...

25
Использовать пустую строку, нулевое или удалить пустое свойство в запросе / ответе API

При передаче объекта через API, например, в формате JSON без схемы, каков идеальный способ вернуть несуществующее строковое свойство? Я знаю, что есть разные способы сделать это, как в примерах в приведенных ниже ссылках. Избегайте нуля Вернуть ноль Удалить пустое свойство Я уверен, что я...