Top "Api-design" questions

API design is the process of determining and exposing a set of consistent method signatures, return values, and documentation intended for use by other developers to allow programmatic access to data.

Private class functions vs Functions in unnamed namespace

I've found myself that I tend not to have private class functions. If possible, all candidates to private class function …

c++ namespaces coding-style static-members api-design
Is it acceptable to return unmodifiableList or should I return array?

I have method List<Foo> getFoos () which gets the data from remote server and returns it. Of course, …

java oop collections api-design
How should a RESTful service expose read-only properties on mutable resources?

I am working on designing a resource for this service which has a set of mutable properties and a set …

http rest api-design
Unable to autoload constant API Controller in Rails 4

I'm creating a simple api endpoint in my Rails 4.2.6 app but am having problems with it. When I hit the …

ruby-on-rails ruby-on-rails-4 api-design
REST API Design: Nested Collection vs. New Root

This question is about optimal REST API design and a problem I'm facing to choose between nested resources and root …

rest api-design conceptual
Why is DialogResult a nullable bool in WPF?

Can anyone think of a good explanation for the fact that result of a dialog is a nullable bool in …

.net wpf api-design dialogresult
Inheritance and Polymorphism in REST API Modeling

I have an object hierarchy that I want to expose through a REST API, and I want to discuss best …

rest api inheritance polymorphism api-design
RESTful API routes design: nested vs. non-nested

My question is about the advantages of nesting resources when building URLs for API purposes. Consider the following two alternatives …

rest restful-url api-design nested-resources nested-routes
Why does Iterables.find() in Guava throw NoSuchElementException, instead of returning null?

I love Google Guava and use it a lot, but there is one method I always find me writing.. public …

guava api-design
Spring Boot REST Design for Search API

I am designing a SpringBoot RESTful API for a Product searching with various attributes (search can be one or more). …

spring-boot api-design spring-rest