Preguntas etiquetadas con api-design

Tuve una acalorada discusión hoy sobre nuestra aplicación MVC. Tenemos un sitio web escrito en MVC ( ASP.NET ), y generalmente sigue el patrón de hacer algo en la vista -> presionar el controlador -> el controlador construye un modelo (llama a un administrador que obtiene los datos, construye...

Estoy tratando de descubrir qué significa realmente la capa anticorrupción. Sé que es una forma de hacer la transición / evitar código heredado o API incorrectas. Lo que no entiendo es cómo funciona y qué lo hace una separación limpia de la capa indeseable. He realizado algunas búsquedas, pero no...

Al diseñar una interfaz RESTful, la semántica de los tipos de solicitud se considera vital para el diseño. GET - Lista de colección o elemento de recuperación PUT - Reemplazar colección o elemento POST - Crear colección o elemento BORRAR - Bueno, erm, eliminar colección o elemento Sin embargo,...

Digamos que tengo una entidad que tiene el atributo "type". Podría haber más de 20 tipos posibles. Ahora me piden que implemente algo que permita cambiar el tipo de A-> B, que es el único caso de uso. Entonces, ¿debo implementar algo que permita cambios de tipo arbitrarios siempre que sean...

Digamos que tengo un punto final REST que toma un entero como parámetro: /makeWaffles?numberOfWaffles=3 En este caso, quiero que el número sea positivo porque no puedo hacer un número negativo de gofres (y solicitar 0 gofres es una pérdida de tiempo). Por lo tanto, quiero rechazar cualquier...

Nuestro servicio se encuentra en 5 ciudades en este momento. Si alguien intenta llamar a nuestro API de servicio desde cualquier otra ciudad, queremos lanzar este error Service not available in your area. La pregunta es, ¿cuál sería el código http apropiado para este error? 503 Servicio no...

Digamos que está codificando una función que toma datos de una API externa MyAPI. Esa API externa MyAPItiene un contrato que establece que devolverá a stringo a number. ¿Se recomienda para protegerse contra cosas como null, undefined, boolean, etc, incluso aunque no es parte de la API de MyAPI?...

Actualmente estoy codificando una API para una red social con Slim Framework. Mi pregunta es: ¿Cuáles son las mejores prácticas cuando no hay filas para devolver en la estructura json? Digamos que esta llamada / v1 / get / movies devuelve 2 filas de los nombres de películas de la tabla: [...

Actualmente estoy trabajando en un proyecto con una organización de la siguiente manera: Cliente : obtiene datos del servidor principal a través de la API REST. Servidor : solicita datos de otros servidores a través de API de terceros API de terceros : servicios fuera de mi control que...

Me preguntaba acerca de esto. Supongamos que tengo un userrecurso con idy namecampos. Si quiero actualizar un campo, podría hacer una solicitud PATCH al recurso como este PATCH /users/42 {"name": "john doe"} Y luego la aplicación actualizará el nombre del usuario 42. Pero, ¿por qué si...

Estoy escribiendo una implementación Java de un juego de cartas, así que creé un tipo especial de Colección que llamo Zona. Todos los métodos de modificación de la Colección de Java no son compatibles, pero hay un método en la API de Zona move(Zone, Card), que mueve una Tarjeta de la Zona dada a sí...

Sigo escuchando a la gente (Crockford en particular) decir que el DOM es una API terrible, pero no justifica realmente esta afirmación. Además de las inconsistencias entre navegadores, ¿cuáles son algunas de las razones por las cuales el DOM se considera tan

Me pregunto por qué java.util.ArrayListpermite agregar null. ¿Hay algún caso en el que me gustaría agregar nulla un ArrayList? Me hago esta pregunta porque en un proyecto que teníamos un error en algún código se agregó nulla la ArrayListy era difícil de detectar dónde estaba el error. Obviamente...

Digamos que en mi solicitud, algunos usuarios nos dan su apellido y otros no. En una respuesta REST API, qué cuerpo se prefiere: Con un valor "nulo": {"firstName": "Bob", "lastName": null} O simplemente una clave faltante: {"firstName":

Estoy trabajando con una API REST que reside en un servidor que maneja datos para una multitud de dispositivos IoT. Mi tarea es consultar al servidor utilizando la API para recopilar información de rendimiento específica sobre dichos dispositivos. En un caso, obtengo una lista de dispositivos...

Cuando se trata de API JSON, ¿es una buena práctica aplanar las respuestas y evitar objetos JSON anidados? Como ejemplo, digamos que tenemos una API similar a IMDb pero para videojuegos. Hay un par de entidades, Juego, Plataforma, ESRBRating y GamePlatformMap que mapean Juegos y...

Tenemos una función API que desglosa un monto total en montos mensuales en función de las fechas de inicio y finalización. // JavaScript function convertToMonths(timePeriod) { // ... returns the given time period converted to months } function getPaymentBreakdown(total, startDate, endDate) {...

Estoy proponiendo cambios a un proyecto de software muy mal diseñado que sufre de una multitud de problemas. En un nivel alto, el proyecto utiliza Angular en el front-end y consume varias API REST; lo cual es genial (no veo la necesidad de cambiar nuestra tecnología o herramientas). El problema es...

¿Hay algún tipo de estándar con respecto a las respuestas de la API HTTP? Después de leer este hilo del discurso comencé a preguntarme. Estamos desarrollando nuestra API HTTP JSON pública en mi trabajo, y no devolvemos nada cuando no es estrictamente necesario (por ejemplo, PUT to / resource /...

En una discusión sobre métodos estáticos y de instancia, siempre pienso que ese Sqrt()debería ser un método de instancia de tipos de números en lugar de un método estático. ¿Porqué es eso? Obviamente funciona en un valor. // looks wrong to me var y = Math.Sqrt(x); // looks better to me var y =...