api-design

Prácticas recomendadas de paginación de API

Me encantaría un poco de ayuda para manejar un extraño caso edge con una API paginada que estoy construyendo. Al igual que m ... ligero posible (es decir, evitar el manejo de sesiones para solicitudes de API). Ejemplos de otras API serían muy apreciados!

¿Cuál es el código de respuesta REST adecuado para una solicitud válida pero un dato vacío?

Por ejemplo, ejecuta una solicitud GET para users/9 pero no hay ningún usuario con id #9. Cual es el mejor código de respuesta? 200 OK 202 Aceptadas 204 Sin contenido 400 Solicitud incorrecta 404 No encontrado

¿Por qué String?¿valueOf (null) lanza una excepción NullPointerException?

De acuerdo con la documentación, el método String.valueOf(Object obj) devuelve: Si el argumento es null, entonces una ca ... known Source) ¿Cómo es que esto está sucediendo? ¿Me está mintiendo la documentación? Es este un error importante en Java?

Mejores prácticas y directrices para diseñar una API [cerrado]

¿Cuáles son algunas pautas y mejores prácticas a las que puedo adherirme al diseñar una API? Como mínimo, sé que una API de ... s pueden ser bastante subjetivos, por lo que estaba buscando algunas pautas concretas relacionadas con un buen diseño de API.

¿Inglés Británico o inglés estadounidense?

Si tiene una API y es un desarrollador con sede en el Reino Unido con una audiencia altamente internacional, debe ser setCo ... la ortografía de GB, o normalmente bastante evidente lo que significan las cosas? ¿Debería ser todo inglés-estadounidense?

¿Las interfaces fluentes violan la Ley de Demeter?

El artículo de wikipedia sobre Ley de Deméter dice: La ley puede declararse simplemente como "use solo un punto". ... .Watermark("Monkey") .RoundCorners(100, Color.Bisque) .Save("test.png"); } Entonces, ¿esto va de la mano?

¿Cómo se define una API buena o mala? [cerrado]

Antecedentes: Estoy tomando una clase en mi universidad llamada "Restricciones de software". En las primeras conferencias a ... a la complejidad "oculta". Es necesario que el usuario/dev construya envoltorios alrededor de la API para que pueda usarse.

Semántica de Endpoints de API

Es un punto final de API el 'método', como https://api.foursquare.com/v2/venues / o la URL completa incluyendo parámetros q ... s dos puntos finales separados o se consideran el mismo punto final? http://myapi.com/somemodel/1http://myapi.com/somemodel/2

Diseño de API y jQuery

A menudo he oído que jQuery ha tomado algunas malas decisiones de API. Aunque jQuery no es mi biblioteca favorita, es la bibl ... or favor, no compare la biblioteca jQuery con marcos completos como dojo y YUI y se queje de la falta de características.

Diseño restful: ¿cuándo usar sub-recursos?

Al diseñar jerarquías de recursos, ¿cuándo se deben usar sub-recursos? Solía creer que cuando un recurso no podía existir si ... ue un recurso no se puede identificar sin otro? ¿Qué relaciones son los sub-recursos destinados y no destinados a modelar?

Funciones de clase privada vs Funciones en un espacio de nombres sin nombre

Me he dado cuenta de que tiendo a no tener funciones de clase privada. Si es posible, todos los candidatos a la función de cl ... encia, necesito exponer menos detalles internos en el archivo de encabezado. ¿Cuál es su opinión - es la práctica correcta?

¿Cuándo defino los métodos objective-c?

Estoy aprendiendo Objective-C, y tengo un fondo de C/C++. En C++ orientado a objetos, siempre debe declarar su método ant ... métodos heredados nunca se (re)definen. Estoy en el camino correcto? ¿Cuándo necesitas definir un selector en Objective-C?

¿Por qué Java no permite sobrescribir equals (Object) en una enumeración?

He notado que el siguiente fragmento... @Override public boolean equals(Object otherObject) { ... } ...no está permiti ... ue requiera sobreescribir equals(Object) para Enum. Tengo curiosidad por saber el razonamiento detrás de este comportamiento.

¿Por qué no hay un método getFirst (iterable)?

Iterables presentan dos métodos para getLast public static <T> T getLast(Iterable<T> iterable); public static ... terable<T> iterable, @Nullable T defaultValue); ¿Hay alguna razón de diseño/implementación para romper la simetría?

¿Cuándo debemos crear nuestras propias clases de excepción de Java?

Desde un buen punto de vista de diseño/práctica, ¿cuándo debemos crear y usar clases de excepción java personalizadas en luga ... otro lado, hay algunas aplicaciones que definen excepciones personalizadas para todo. ¿Cuál es la mejor práctica? Gracias!

Diseño de API REST: Colección anidada vs. Nueva raíz

Esta pregunta es sobre el diseño óptimo de la API REST y un problema al que me enfrento para elegir entre recursos anidados y ... sses/X7N7/Employees, lo que hace que todo sea aún más confuso. ¿Hay una tercera vía más limpia en la que no estoy pensando?