Preguntas etiquetadas con api-design

Por ejemplo, ejecuta una solicitud GET users/9pero no hay ningún usuario con ID # 9. ¿Cuál es el mejor código de respuesta? 200 OK 202 aceptado 204 Sin contenido 400 Petición Incorrecta 404 No encontrado

332 rest  http  api-design 

Por lo que puedo decir, cada recurso individual debe tener solo una ruta canónica . Entonces, en el siguiente ejemplo, ¿cuáles serían los buenos patrones de URL? Tomemos como ejemplo un resto de representación de empresas. En este ejemplo hipotético, cada compañía posee 0 o más departamentos y cada departamento …

301 rest  api-design 

Me encantaría obtener ayuda para manejar un caso marginal extraño con una API paginada que estoy construyendo. Al igual que muchas API, esta página ofrece grandes resultados. Si consulta / foos, obtendrá 100 resultados (es decir, foo # 1-100), y un enlace a / foos? Page = 2 que debería …

288 rest  pagination  api-design 

A diferencia de C # IEnumerable, donde una tubería de ejecución se puede ejecutar tantas veces como queramos, en Java una secuencia se puede 'iterar' solo una vez. Cualquier llamada a una operación de terminal cierra la secuencia y la deja inutilizable. Esta 'característica' le quita mucho poder. Me imagino …

239 java  java-8  java-stream  api-design 

Tenga en cuenta que tengo una comprensión rudimentaria de REST. Digamos que tengo esta URL: http://api.animals.com/v1/dogs/1/ Y ahora, quiero hacer que el servidor haga ladrar al perro. Solo el servidor sabe cómo hacer esto. Digamos que quiero que se ejecute en un trabajo CRON que hace que el perro ladre …

142 api  rest  url  api-design  restful-architecture 

Quiero hacer que mi API RESTful sea muy predecible. ¿Cuál es la mejor práctica para decidir cuándo hacer una segmentación de datos utilizando el URI en lugar de utilizar parámetros de consulta? Para mí tiene sentido que los parámetros del sistema que admiten la paginación, la clasificación y la agrupación …

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

De acuerdo con la documentación, el método String.valueOf(Object obj)devuelve: si el argumento es null, entonces una cadena igual a "null"; de lo contrario, obj.toString()se devuelve el valor de . Pero, ¿cómo es que cuando trato de hacer esto? System.out.println("String.valueOf(null) = " + String.valueOf(null)); arroja NPE en su lugar? (¡pruébalo tú …

127 java  null  nullpointerexception  overloading  api-design 

El siguiente código arroja NullPointerException: int num = Integer.getInteger("123"); ¿Mi compilador invoca getIntegeren null ya que es estático? ¡Eso no tiene ningún sentido! ¿Qué esta pasando?

106 java  integer  nullpointerexception  api-design  autoboxing 

Si tiene una API y es un desarrollador con sede en el Reino Unido con una audiencia muy internacional, si su API es setColour() o setColor() (Para tomar una palabra como ejemplo simple). Los ingenieros del Reino Unido suelen estar bastante a la defensiva acerca de su ortografía "correcta", pero …

93 api  naming-conventions  api-design 

Tengo una API REST JSON. Hay un apretón de manos que le dará una ficha válida por 15 minutos. Todas las llamadas que hagas dentro de esos 15 minutos deberían funcionar correctamente. Después de los 15 minutos, estoy devolviendo un objeto de error (incluye código, mensaje, éxito = falso) pero …

83 web-services  rest  api-design